> From: "Nicholas \"Indy\" Ray" <[email protected]> > To: [email protected] > Sent: Thursday, May 5, 2011 12:10:33 PM > Subject: Re: [rust-dev] status, triage
> As someone who's just begun to learn my way around rust, (and taking > notes) and likely to try to contribute to the tutorial, I much prefer > having the tutorial in git with the code. It seems that overall trying > to keep any documentation out of the git repo is a recipe to get it > out-of-sync with the current revision. Just see LLVM and much of their > wiki-only documentation, it's almost uniformly out of date. It's a good point. However, right now the Rust documentation doesn't agree with the code anyway -- sometimes it's behind and sometimes it's ahead. Now, if all the code examples in the (not-yet-existent) tutorial automatically built and ran when we built the doc, that would be ideal! That probably rules out the wiki idea, though. Going even further, we could make breaking the doc build in that way count as Breaking The Build. Lindsey _______________________________________________ Rust-dev mailing list [email protected] https://mail.mozilla.org/listinfo/rust-dev
