@efindlay You got it! Great start.
First draft for the community pages is at https://github.com/efindlay/rust-www.Wordsmithing still required. Three sections require continuous updating, “Past Conferences, Talks and Workshops”, “User Groups” and “Upcoming Conferences, Talks and Workshops”. I’ve tried to make these as simple as possible to optimize the value added to labor ratio. I thought about automating “Upcoming Events” but while most groups are using Meetup, Japan and China are not, so the added complexity would outweigh usefulness, I think. People, in any case, are probably only interested in their own local group, rather than a calendar for all groups. I haven’t touched the Rust front page on my fork, so need to view from [localhost]/community.html. Any feedback would be greatly appreciated, particularly for the dev section as I’m not really familiar about how this would be used.
It was noted on IRC that our policies about which platforms are supported (tier 1) are not spelled out anywhere. In general, project policy is scattered, and there is need for accessing it all in one place. Perhaps on the community page?
@efindlay Wow! I’ve reviewed your current work and it’s great. Below are my very rough notes - sorry they are so brief. I think after your next revision you should go ahead and do the PR and let’s start integrating it.
“We have a great community and we want to keep it that way”. We can be even stronger than this, really crow about it. ex: “Rust is more than just a revolutionary programming language; it is a tight-knit community with a legendary dedication to kindness and inclusiveness (link-to-evidence)”.
“Our code of conduct can be found here.” Instead of calling out links, prefer contextual links: “These tenets are captured in our code of conduct (link), the prime policy document of The Rust Project, which should be observed in all official communications channels, including blah blah blah.” May be too wordy, but something like.
News sources first is good. Move ‘how to get help’ second. Not sure about the rest.
Let’s put TWiR first, with a description of its role, indicate that it’s the best source for curated news about the project. Blog second is good. Let’s also add /r/rust. Even though it’s role is contrroversial, it’s important. Indicate it’s an unofficial source in the description.
Move ‘upcoming conferences…’ to ‘user groups, conferences’ section.
How to get help
This only lists #rust. I wonder if we should be more comprehensive, though some channels like #rust-internals may be more suited for the contributing page.
‘Join a Mail list’ links to reddit. This is weird. I’d suggest leaving this off and linking reddit from news.
Add a link to the moderation team email, explaining how to resolve harrassment, conflicts etc.
People / Rust development
Perhaps this could be reconceptualized as a guide to the project governance structure. The project is lead by the teams, who are responsible for something or other, leading the RFC process by which the language evolves. Legal link can probably also be integrated here with explanation.
Leave contributing, issue tracking to the contributing page.
No calendar link or embedded calendar.
Style might be improved but we can tweak later, and we’ll learn more about style as other pages are completed.
User groups page
It says contact the rust community team, but one could also simply open a PR against rust-www, and I think this should be stated to encourage contribution.
Past conference talks and workshops
Good idea, but not enough content to justify yet.
Seems ok. Headers need anchors for external links.
There may be room for a more general ‘policy’ page, but I haven’t put much thought into it.
I hope I’m not diverging the topic, but a nice future mission would be making and maintaining “Are we there yet?” pages, linked somewhere from the official rust site. The “Are we web yet?” page is abandoned it seems, and the “Are we IDE yet?” is a draft. I find them to be an informative and concise review of the ecosystem, if only they were kept up-to-date. They are a nice form of ecosystem FAQ.
In the community section, I would like to put in something like:
According to CodeTriage, the Rust language has most contributors than any programming language. If you want to join in the fun but aren’t sure about the process, please read ’Introduction to Contributing in Rust’ and contact our Contributor First Contact at firstname.lastname@example.org."
but that would mean such person would need to exist …
Forward to the rust-community mailing list on google. We’re the switchboard.
I’ll be writing a short page to that effect as one part of https://users.rust-lang.org/t/mentoring-newcomers-to-the-rust-ecosystem/3088
@sirDonQui, I’m really sorry - I inadvertantly created a contribution page for ‘2. Community’ without realizing it was a separate mission.
Two points I think might be worth emphasizing more on the front page:
The size of the Rust community (most number of contributors to a programming language).
The degree to which Rust is open (http://rustcamp.com/schedule.html#cnichols)
No worries. I hadn’t done much on it yet.
@brson: would missions 3 completed with this PR already then? Or does it need more work/should I take another look after?
I plan on writing up the mentorship thing on Sunday, I can do any additional work needed for the contributions page then if you don’t mind.
I think community is getting close to ready. The others need further revision. I’m doing some review now.
Internationalizing the Rust Website
Internationlization of the website is important to a) encouraging an inclusive and diverse community, b) give more people an opportunity to get into Rust.
I suggest multiple front pages,
etc. for different groups. The Ruby homepage is a good example of how this might work.