I'm proposing that we split the tutorial & guides into a much better system.
There's a few problems with the current system: * The tutorial is a massive page that seems to have everything stuffed into it.. * Other guides are hard to notice (I sure didn't see the links at the bottom right away). * Other guides aren't made as important as the tutorial. * The user flow is kinda ineffective. I don't think splatting a bunch of the features in a single page is a great starter. I'm thinking that something like [Julia's docs]( http://docs.julialang.org/en/release-0.2/manual/) would serve us better. It would allow us to properly guide the user through each topic separately, instead of having a giant page that one could get overwhelmed reading. Another example is [Github's docs](https://developer.github.com/v3/) Because this is curated docs, there's some flexibility in what we're able to do. Github, for example, uses [Nanoc](http://nanoc.ws/), which is like Jekyll but way more powerful. We could include the ability to compile the nanoc site in the Makefile and we could have rustdoc to still parse the markdown and ensure the examples are correct. This would allow us the opportunity to properly guide the user through each element of Rust and we could split things into sections, such as `Introduction`, `Advanced`, etc... Within the introduction, we could have the 30-minute introduction, along with other material. Thoughts? -- Daniel Fagnan Titan Analytics Inc. www.titananalytics.com M: (780) 983-4997
_______________________________________________ Rust-dev mailing list [email protected] https://mail.mozilla.org/listinfo/rust-dev
