Rusty Web Improvement Bureau

@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.

Notes

Good intro.

“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.

Structure

News sources first is good. Move ‘how to get help’ second. Not sure about the rest.

News

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.

User Groups…

Seems good.

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.

Other notes

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

Awesome.

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.

Legal page

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.