Rename TARPL to the Rustonomicon

[Gankra]

Closes #27412

r? @brson

[Gankra]

This is also the final resolution of #13871

[huonw]

I think that Rustonomicon sounds slightly better.

[steveklabnik]

👍 to o

Sent from my iPhone

On Jul 31, 2015, at 14:23, Huon Wilson notifications@github.com wrote:

I think that Rustonomicon sounds slightly better.

―
Reply to this email directly or view it on GitHub.

[killercup]

While The Advanced Rust Programming Language sounds like a serious manual full of technical details and concepts, The Rustonomicon will prepare the reader for @gankro's cheerful writing! 😄

[nham]

With this change, I suppose the book will have to be translated into medieval Arabic. Many spells will need to be added as well, but this can all be work for future PRs.

[sweber6106]

"The Advanced Rust Programming Language" makes it sound like there was a prior, not-so-advanced language. "The Rust Programming Language" is fine and tight. Add a sub-title if absolutely required.

[bors]

☔ The latest upstream changes (presumably #27453) made this pull request unmergeable. Please resolve the merge conflicts.

[jroesch]

👍

[brson]

This translates to the ultimate URL of the doc and I wonder if 'doc/rustonomicon' would be clearer, more guessable.

[Gankra]

Yes -- I personally felt rustonomicon was a bit too long, and also expect people to mess up the vowel after rust. I also don't expect much cold-typing of the URL. just autocompleteing/linking/bookmark/search.

[brson]

Well, I like this a lot. It has a lot of branding possibilities in physical publication, and it has a Rust-rich backstory with the Lovecraft connection. It does nothing at all to stem the criticism about the casual tone in our docs, but I'm ok doubling down on the whimsy for these docs (and the casual reputation of our docs is probably more good than bad). The reference and other books can be expanded in a more straightforward technical style.

(As a recall Gankro suggesting once we might consider styling it differently to suggest the dark knowledge within, but that can be done later).

[Gankra]

(rebased)

[Gankra]

Per offline discussion I've added a subtitle for SEO/clarity/auto-complete purposes. I will be submitting a patch to our nginx config to make adv-book/rustonomicon/rustinomicon redirct to nomicon

@bors r=brson

[bors]

📌 Commit ca902dd has been approved by brson

[edunham]

Summarizing IRC discussion this morning in #rust-internals about the name:

• Concerns about the name being difficult to spell and remember for non-Lovecraft fans will be addressed by adding the subtitle "The Dark Arts of Advanced and Unsafe Rust Programming"
• Because Rustdoc doesn't exactly support subtitles, the title in the pages will be "Rustonomicon: The Dark Arts of Advanced and Unsafe Rust Programming".
• Since the name is hard to spell, the docs will live at the /nomicon URL and /rustonomicon, /rustinomicon, and /adv-book will all redirect to /nomicon. I'll add these redirects once the PR lands.

[Gankra]

@edunham I actually settled on an <h4> for the subtitle, but otherwise 👍

[bors]

⌛ Testing commit ca902dd with merge ce719ee...

[bors]

💔 Test failed - auto-mac-32-opt

[alexcrichton]

@bors: retry

On Mon, Aug 3, 2015 at 8:50 PM, bors notifications@github.com wrote:

[image: 💔] Test failed - auto-mac-32-opt
http://buildbot.rust-lang.org/builders/auto-mac-32-opt/builds/6009

—
Reply to this email directly or view it on GitHub
#27444 (comment).

[bors]

⌛ Testing commit ca902dd with merge 7a7789d...

[bors]

☀️ Test successful - auto-linux-32-nopt-t, auto-linux-32-opt, auto-linux-64-nopt-t, auto-linux-64-opt, auto-linux-64-x-android-t, auto-mac-32-opt, auto-mac-64-nopt-t, auto-mac-64-opt, auto-win-gnu-32-nopt-t, auto-win-gnu-32-opt, auto-win-gnu-64-nopt-t, auto-win-gnu-64-opt, auto-win-msvc-32-opt, auto-win-msvc-64-opt

[pnkfelix]

\(;,;)/

[strega-nil]

You've met with a terrible fate, haven't you...