Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Daniel Micay
On Mon, Aug 12, 2013 at 6:09 PM, Jordi Boggiano wrote: > On 12.08.2013 23:58, Graydon Hoare wrote: >> On 13-08-12 02:06 PM, Daniel Micay wrote: >> >>> I don't think it makes sense to switch from pandoc. It's more >>> featureful than the other generators, and has many supported output >>> formats.

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jordi Boggiano
On 12.08.2013 23:58, Graydon Hoare wrote: > On 13-08-12 02:06 PM, Daniel Micay wrote: > >> I don't think it makes sense to switch from pandoc. It's more >> featureful than the other generators, and has many supported output >> formats. The perceived popularity is much less important than >> quanti

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Graydon Hoare
On 13-08-12 02:06 PM, Daniel Micay wrote: > I don't think it makes sense to switch from pandoc. It's more > featureful than the other generators, and has many supported output > formats. The perceived popularity is much less important than > quantifiable differences between the alternatives. Yeah

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Daniel Micay
On Mon, Aug 12, 2013 at 4:41 PM, Jordi Boggiano wrote: >> I noticed it because the code samples weren't syntax highlighted but >> there are some other quirks with lists/headers. Rust's documentation >> doesn't stick to the very small part of the language that's common >> across most implementation

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jordi Boggiano
On 12.08.2013 22:47, Jeaye wrote: > Searching for std::hashmap::HashMap, I typed "Hash". When the ideal > results didn't show up, I added an 'M' to make my query "HashM" at this > point, I'm told nothing is found and that I should try DDG. However, if > I continue to type 'ap' to make my query "Has

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jeaye
Searching for std::hashmap::HashMap, I typed "Hash". When the ideal results didn't show up, I added an 'M' to make my query "HashM" at this point, I'm told nothing is found and that I should try DDG. However, if I continue to type 'ap' to make my query "HashMap", I get proper results. This seem

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jordi Boggiano
> I noticed it because the code samples weren't syntax highlighted but > there are some other quirks with lists/headers. Rust's documentation > doesn't stick to the very small part of the language that's common > across most implementations. It would mean no nested lists, tables, > code snippets, d

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Daniel Micay
On Mon, Aug 12, 2013 at 3:36 PM, Jordi Boggiano wrote: > On 12.08.2013 19:39, Daniel Micay wrote: >> A nitpick is that the markdown isn't being rendered correctly, at >> least not how it would be with an up-to-date pandoc. > > Can you give specifics? It's using the npm marked package right now wit

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jordi Boggiano
On 12.08.2013 20:19, Patrick Walton wrote: > On 8/13/13 4:15 AM, Evan Martin wrote: >> This is vague, I feel like there's too many clicks to get into the >> details of something. E.g. if I'm trying to see what the std module >> offers, the overview page just lists modules without any description.

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Armin Ronacher
Hi, On 12/08/2013 20:35, Jordi Boggiano wrote: Not in full with definitions and docs etc. like the current docs do. I find this particularly messy when there is more than one liner docs (which I hope we have one day;). It wouldn't be impossible to add obviously, but I'd rather focus on one use c

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jordi Boggiano
On 12.08.2013 19:27, Alex Crichton wrote: > This is awesome! If you're taking suggestions, it seems like one case > can be improved. If you just heard about this TreeMap thing, you'd go > to the dox, search for treemap (awesome live update btw), hit the > first link, and then get bombarded with a *

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jordi Boggiano
On 12.08.2013 19:39, Daniel Micay wrote: > A nitpick is that the markdown isn't being rendered correctly, at > least not how it would be with an up-to-date pandoc. Can you give specifics? It's using the npm marked package right now with GFM (github flavoured markdown) enabled. As far as I could se

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Jordi Boggiano
On 12.08.2013 20:10, Armin Ronacher wrote: > Hi, > > On 12/08/2013 16:33, Corey Richardson wrote: >> Super thanks to Jed Estep and Huon Wilson, who helped a lot with the >> backend. And, of course, this would have taken 3x longer and the >> result would have been half as good if it were not for Jo

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Patrick Walton
On 8/13/13 4:15 AM, Evan Martin wrote: This is vague, I feel like there's too many clicks to get into the details of something. E.g. if I'm trying to see what the std module offers, the overview page just lists modules without any description. if I click into ascii, I see a list of functions b

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Armin Ronacher
Hi, On 12/08/2013 16:33, Corey Richardson wrote: Super thanks to Jed Estep and Huon Wilson, who helped a lot with the backend. And, of course, this would have taken 3x longer and the result would have been half as good if it were not for Jordi Boggiano and his amazing work with the web frontend.

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Daniel Micay
On Mon, Aug 12, 2013 at 11:33 AM, Corey Richardson wrote: > Hello all, > > I present to you: rustdoc_ng http://seld.be/rustdoc/master/index.html > > It's basically done, only a few minor bugs remain, as well as the > listing of `pub use`'s. I've been using it as my only doc browser the > past day

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Alex Crichton
This is awesome! If you're taking suggestions, it seems like one case can be improved. If you just heard about this TreeMap thing, you'd go to the dox, search for treemap (awesome live update btw), hit the first link, and then get bombarded with a *lot* of type signatures. If all you wanted to fin

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread SiegeLord
On 08/12/2013 12:15 PM, Evan Martin wrote: You could make the links to source more stable by linking to exactly the version of the source that the docs were built from. E.g. rather than having http://seld.be/rustdoc/master/std/either/fn.lefts.html link to https://github.com/mozilla/rust/blob/mast

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Robert Knight
Hello Corey, Thanks for your work on this. The live search is especially welcome. > The relative weights of fonts on the page don't correspond to their > importance. That is, the "TUTORIAL | MANUAL" bit is the largest, boldest, > most whitespaced piece of the page but they're only links you're

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Corey Richardson
On Mon, Aug 12, 2013 at 12:15 PM, Evan Martin wrote: > I love that there are cross-references within the code snippets. It's great > to be able to quickly look up what a trait means. I noticed that "prelude" > in the discussion on http://seld.be/rustdoc/master/std/index.html isn't a > link, is t

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Evan Martin
This looks really great. Some random feedback from a skim. I love that there are cross-references within the code snippets. It's great to be able to quickly look up what a trait means. I noticed that "prelude" in the discussion on http://seld.be/rustdoc/master/std/index.html isn't a link, is t

Re: [rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Michael Woerister
On 08/12/2013 05:33 PM, Corey Richardson wrote: Hello all, I present to you: rustdoc_ng http://seld.be/rustdoc/master/index.html It's basically done, only a few minor bugs remain, as well as the listing of `pub use`'s. I've been using it as my only doc browser the past day and it's quite wonder

[rust-dev] rustdoc_ng: 95% done

2013-08-12 Thread Corey Richardson
Hello all, I present to you: rustdoc_ng http://seld.be/rustdoc/master/index.html It's basically done, only a few minor bugs remain, as well as the listing of `pub use`'s. I've been using it as my only doc browser the past day and it's quite wonderful. The search is still a bit primitive, but tha