Some short history. Rust by Example was originally created as a project outside of the standard Rust language project with its own website and development. Later on, the domain and project were donated to the Rust Language project. It has been maintained by the Rust Language project since then in its own repository and keeping its website. We link to it on the main documentation page.
This setup has served us well enough. But it’s not without problems. It’s another domain we have to keep track of. Unlike the main site, it’s not localized or in a state to be localizable. As it looks to be its own domain, it’s not clear that people can contribute to it not does it feel like it has the official Rust documentation seal. It’s also using its own build system (gitbook) which adds to the difficulty of contributing to.
I’m proposing that we try to bring Rust by Example into the rust-lang.org fold. Convert it over to mdBook, improving mdBook where necessary. I’ve brought this up in the last docs team meeting, and others were receptive to the idea. I’m not entirely sure what all work needs to be done, so that’s what I’m asking here. What needs to be done to get Rust by Example into rust-lang.org?
It's good to record all that here, but in the interest of doing one thing at a time, I'm going to try to focus on the requirements for the editor:
This is long overdue, I know