# Rusty Web Improvement Bureau

**URL:** <https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572>\
**Category:** Uncategorized\
**Created:** [August 28, 2015, 7:34pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572 "2015-08-28T19:34:05Z")\
**Posts on this page:** 16\
**Page:** 3

<div class="post-metadata">

**Author:** ![efindlay](https://avatars.discourse-cdn.com/v4/letter/e/3ec8ea/32.png) [@efindlay](https://internals.rust-lang.org/u/efindlay)\
**Post date:** [October 9, 2015, 7:28am UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/41 "2015-10-09T07:28:20Z")

</div>

Two points I think might be worth emphasizing more on the front page:

1. The size of the Rust community (most number of contributors to a programming language).

2. The degree to which Rust is open ([http://rustcamp.com/schedule.html#cnichols](http://rustcamp.com/schedule.html#cnichols))

---

<div class="post-metadata">

**Author:** ![sirDonQui](https://avatars.discourse-cdn.com/v4/letter/s/fbc32d/32.png) [@sirDonQui](https://internals.rust-lang.org/u/sirDonQui)\
**Post date:** [October 9, 2015, 1:50pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/42 "2015-10-09T13:50:49Z")

</div>

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?

---

<div class="post-metadata">

**Author:** ![Manishearth](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/manishearth/32/50_2.png) [@Manishearth](https://internals.rust-lang.org/u/Manishearth)\
**Post date:** [October 9, 2015, 1:53pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/43 "2015-10-09T13:53:10Z")

</div>

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.

---

<div class="post-metadata">

**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\
**Post date:** [October 12, 2015, 4:24pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/44 "2015-10-12T16:24:32Z")

</div>

@sirDonQui @Manishearth, I do think that we should revisit the contributing page after @efindlay’s work lands. I haven’t reviewed it closely, but suspect it can be improved yet, more eyes are good.

@efindlay is going to have a go at [#5 too, the doc page](https://github.com/rust-lang/rust-www/issues/179).

---

<div class="post-metadata">

**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\
**Post date:** [October 21, 2015, 9:44pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/45 "2015-10-21T21:44:36Z")

</div>

@efindlay has three PRs up now: [#2 community](https://github.com/rust-lang/rust-www/pull/201), [#3 contributing](https://github.com/rust-lang/rust-www/pull/199), and [#5 docs](https://github.com/rust-lang/rust-www/pull/200).

I think community is getting close to ready. The others need further revision. I’m doing some review now.

---

<div class="post-metadata">

**Author:** ![efindlay](https://avatars.discourse-cdn.com/v4/letter/e/3ec8ea/32.png) [@efindlay](https://internals.rust-lang.org/u/efindlay)\
**Post date:** [October 25, 2015, 2:02am UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/46 "2015-10-25T02:02:30Z")

</div>

### 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,

- [https://www.rust-lang.org/cn/](https://www.rust-lang.org/cn/)
- [https://www.rust-lang.org/en/](https://www.rust-lang.org/en/)
- [https://www.rust-lang.org/it/](https://www.rust-lang.org/it/)
- [https://www.rust-lang.org/jp/](https://www.rust-lang.org/jp/)

etc. for different groups. The [Ruby](https://www.ruby-lang.org/en/) homepage is a good example of how this might work.

---

<div class="post-metadata">

**Author:** ![skade](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/skade/32/3333_2.png) [@skade](https://internals.rust-lang.org/u/skade)\
**Post date:** [October 26, 2015, 7:55am UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/47 "2015-10-26T07:55:08Z")

</div>

As (somewhat sleeping) member of the german localization team of [ruby-lang.org](http://ruby-lang.org). I’d like to add a few comments on how it works there to make sure it runs smoothly (not to scare you off, but to clarify):

- An accepted translation must have a translation team of 3 people at all times
- They should strive to translate all news (especially security and version announcements). This can be done with a delay, so that the lead language isn’t delayed.
- All translations should be proofread.
- Specialized content is allowed, e.g. the german ruby board is only featured on the german page.
- It means that the website must stay rather small in scope.

That means we need ~15 people for just 5 translations.

Still, the effect of this should not be underestimated: people appreciate if they can read the initial information in their language and might have an easier time grasping changes, etc.

It especially leads to good outreach in often-forgotten parts of the world, e.g. southern america or the asian parts of the world.

---

<div class="post-metadata">

**Author:** ![efindlay](https://avatars.discourse-cdn.com/v4/letter/e/3ec8ea/32.png) [@efindlay](https://internals.rust-lang.org/u/efindlay)\
**Post date:** [October 26, 2015, 12:43pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/48 "2015-10-26T12:43:42Z")

</div>

@skade, that’s useful information, and very good point about outreach. Ongoing translation is a huge job. Regarding Rust, is the German discussion forum completely independent in content from the English one or is there some translation there too? Also, what happens about moderation of the Rust German discussion forum?

I had a more detailed look at the Ruby site. I think its a good model to get ideas from. The website is a ‘somewhat’ static mirror, except for a news section on the front page which seems to be updated regularly in almost all the languages they have available. [The github source](https://github.com/ruby/www.ruby-lang.org/) shows that the news section is the most regularly updated section.

I think this structure, where each language is a rough mirror of each other language is good because it gives equal weight to all languages. I say ‘rough’ because there are really four categories of pages:

#### 1 Direct mirror pages

These probably need to be limited as much as reasonable because a change in one page needs to be reflected in all languages, making these pages difficult to manage when changes are required.

#### 2 English language only pages

These pages are linked to from all languages (e.g. User Group List and Main Documentation. Examples are a complete User Group list, and the main documentation, which like Rust is generated automatically from the sourcecode. These pages are the easiest to changes because they have no dependencies.

#### 3 Language specific static pages

These usually follow a direct pattern but with distinct content. For example, User Group pages have information specific to that language, and a link to English UG complete list. These pages are easy to change because they have no dependencies.

#### 4 Ongoing Translations

- News

- Translation of discussion forums.

This is where the hard work is.

---

<div class="post-metadata">

**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\
**Post date:** [October 29, 2015, 11:06pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/49 "2015-10-29T23:06:12Z")

</div>

Mission 2, the community page [is merged](https://github.com/rust-lang/rust-www/pull/201). Thanks @efindlay.

Edit: Also, good idea thinking about how to manage the foreign-language and unofficial sources of docs.

---

<div class="post-metadata">

**Author:** ![GuillaumeGomez](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/guillaumegomez/32/2510_2.png) [@GuillaumeGomez](https://internals.rust-lang.org/u/GuillaumeGomez)\
**Post date:** [October 29, 2015, 11:36pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/50 "2015-10-29T23:36:34Z")

</div>

Like told on IRC, I think it might be interessant to add links to specific languages channels. As far as I know, there is a spanish one, french one and russian one. It could motivate people to start going further into rust if they have people who could help them in their mother tongue.

---

<div class="post-metadata">

**Author:** ![efindlay](https://avatars.discourse-cdn.com/v4/letter/e/3ec8ea/32.png) [@efindlay](https://internals.rust-lang.org/u/efindlay)\
**Post date:** [October 30, 2015, 12:36am UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/51 "2015-10-30T00:36:37Z")

</div>

Hello, There's suddenly a problem with Rustdocs header, Eric

 ![](https://us1.discourse-cdn.com/flex002/uploads/rustlang/original/2X/9/900ab1255cab32b3957bbec5e1f1e912cdd072ca.png)

---

<div class="post-metadata">

**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\
**Post date:** [October 30, 2015, 12:44am UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/52 "2015-10-30T00:44:38Z")

</div>

Huh. That’s strange. It shouldn’t be related to the website changes though, but the deployment of the 1.4 docs. FWIW I don’t see it here.

---

<div class="post-metadata">

**Author:** ![efindlay](https://avatars.discourse-cdn.com/v4/letter/e/3ec8ea/32.png) [@efindlay](https://internals.rust-lang.org/u/efindlay)\
**Post date:** [October 30, 2015, 12:46am UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/53 "2015-10-30T00:46:37Z")

</div>

OK here now.

---

<div class="post-metadata">

**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\
**Post date:** [November 6, 2015, 8:30pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/54 "2015-11-06T20:30:52Z")

</div>

This week [there was a big response to @AndrewBrinker’s FAQ](https://github.com/rust-lang/rust-www/pull/202). It’s going to be really good.

I [reviewed and made edits to @efindlays contributing page](https://github.com/rust-lang/rust-www/pull/199). Feeling good about the direction this is going, but it’s a tough thing to try to be succinct but also provide a way for newbies to find _all the right info_.

I also reviewed [@efindlay’s docs page](https://github.com/rust-lang/rust-www/pull/200). There’s so much documentation out there, and again we’ve got to figure out a streamlined way to make sure newbies can find all the good stuff. This page feels difficult to me.

Once the docs change we can redo the navbar.

We’re still in need of an improved example for the front page.

---

<div class="post-metadata">

**Author:** ![brson](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/brson/32/5197_2.png) [@brson](https://internals.rust-lang.org/u/brson)\
**Post date:** [November 30, 2015, 9:23pm UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/55 "2015-11-30T21:23:38Z")

</div>

I’ve posted a new PR for the [contributing page](https://github.com/rust-lang/rust-www/pull/229).

---

<div class="post-metadata">

**Author:** ![system](https://sea2.discourse-cdn.com/flex002/user_avatar/internals.rust-lang.org/system/32/14092_2.png) [@system](https://internals.rust-lang.org/u/system)\
**Post date:** [March 25, 2019, 8:25am UTC](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572/56 "2019-03-25T08:25:04Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.

[Previous page](https://internals.rust-lang.org/t/rusty-web-improvement-bureau/2572.md?page=2)
