Broken and inconsistent links in tutorial and manual.

[anshin]

Under the Scope heading under Introduction (in tutorial.md), the "language reference" link leads to rust.html instead of rust.md. It's a relative link, but I would suggest changing it to .md and redirecting on the actual site.

The note about the Sublime Text 2 is in the tutorial.md file, but it's missing from the main site.

http://doc.rust-lang.org/doc/tutorial.html seems to describe Rust 0.4 while everything else seems to describe 0.3.

The links in rust.md and on http://dl.rust-lang.org/doc/rust.html to the core library and standard library are broken.

I'll comment if I discover more.

[brson]

I fixed the links (on incoming).

The docs are hosted on amazon s3, and I'm not sure how to set up redirects there (@graydon would have to do it), so I haven't changed the links to .md.

Where else would you like to see the Sublime Text 2 support mentioned (i.e. what do you mean by 'main site')? The editor discussion on the getting started wiki page does link to another page that lists the Sublime Text 2 package. I'm not sure that we should actually mention Sublime Text 2 in the tutorial since it isn't officially supported.

I'm open to suggestions about how to address versioning in docs. rust-lang.org links to the current release docs (not the one you mentioned), but the wiki additionally links to the current docs from the git master branch.

[anshin]

Sublime Text 2 is mentioned on the github tutorial but not on http://dl.rust-lang.org/doc/0.3/tutorial.html or http://dl.rust-lang.org/doc/tutorial.html, and I was using "main site" to refer to both of these, for some reason. I really should have been more clear.

As for versioning, when I posted this issue, I wasn't sure how I managed to get to the 0.4 docs. Apparently, it was through the rust.md introduction which seems to lead to an 0.4 version of the docs. The github docs just need to lead to the version of the docs linked to from http://rust-lang.org.

I also forgot that the tarball link on the github tutorial leads to 0.4.

Edit: I would suggest redirecting http://dl.rust-lang.org/doc/{filename} to the "current version" and moving 0.4 to http://dl.rust-lang.org/doc/0.4/{filemame}

Edit again: my carets around the word filename didn't work-- I assume they were treated as HTML despite the backslash.

[brson]

I think I will make the links in rust.md relative so that they lead to the correct version (instead of always linking to whatever's in master)

[anshin]

You read my mind. I think that's the last of the issues I've noticed.

[brson]

Ok, those three external links in the manual are relative now. This will all take time to trickle down to the website.

[brson]

Thanks for your help.

[anshin]

Not sure if you noticed my edit, so repeating it here. The links on the tutorial could redirect to the "current version" (to avoid the versioning issue I experienced and the necessity of updating the docs each time the version changes), while 0.4 could be moved to /docs/0.4/.

Anyway, thanks a lot. I look forward to using Rust.