Re: ddox-generated Phobos documentation is available for review

2014-12-22 Thread Andrei Alexandrescu via Digitalmars-d
On 12/11/14 5:05 PM, Martin Nowak wrote: On 03/10/2014 03:56 PM, Andrei Alexandrescu wrote: All: how does one turn off css hyphenation? Andrei You're again using that crappy JS hyphenation? Last time we had a performance problem with it, I wrote this super efficient D library

Re: ddox-generated Phobos documentation is available for review

2014-12-11 Thread Tobias Pankrath via Digitalmars-d
On Monday, 10 March 2014 at 03:44:54 UTC, Andrei Alexandrescu wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library http://dlang.org/library-prerelease I needed to

Re: ddox-generated Phobos documentation is available for review

2014-12-11 Thread Martin Nowak via Digitalmars-d
On 12/12/2014 02:05 AM, Martin Nowak wrote: You're again using that crappy JS hyphenation? No, you don't it's css hyphenation. Sorry for the tone.

Re: ddox-generated Phobos documentation is available for review

2014-12-11 Thread Martin Nowak via Digitalmars-d
On 03/10/2014 03:56 PM, Andrei Alexandrescu wrote: All: how does one turn off css hyphenation? Andrei You're again using that crappy JS hyphenation? Last time we had a performance problem with it, I wrote this super efficient D library http://code.dlang.org/packages/hyphenate. It could

Re: ddox-generated Phobos documentation is available for review

2014-12-11 Thread Martin Nowak via Digitalmars-d
On 12/11/2014 03:45 PM, Tobias Pankrath wrote: std.container.Array is shadowed by std.container.Array!bool. redBlackTree shadows RedBlackTree as well. We fixed that issue already, please have a look at the preview. https://dlang.dawg.eu/library/index.html

Re: ddox-generated Phobos documentation is available for review

2014-03-12 Thread Sönke Ludwig
Am 11.03.2014 16:12, schrieb Andrei Alexandrescu: On 3/11/14, 6:55 AM, Ivan Kazmenko wrote: http://dlang.org/library Looks nice! I second the opinion that Disqus might have a better alternative. Its loading after the page was rendered looks clumsy, its style does not match that of

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Dicebot
On Monday, 10 March 2014 at 15:08:07 UTC, Andrei Alexandrescu wrote: On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available? I don't like the very concept of comments integrated with the docs and can't accept PHP example as authority. It

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Ivan Kazmenko
http://dlang.org/library Looks nice! I second the opinion that Disqus might have a better alternative. Its loading after the page was rendered looks clumsy, its style does not match that of dlang.org's... the whole thing is somehow out of place. Ivan Kazmenko.

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Matej Nanut
On 11 March 2014 14:09, Dicebot pub...@dicebot.lv wrote: On Monday, 10 March 2014 at 15:08:07 UTC, Andrei Alexandrescu wrote: On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available? I don't like the very concept of comments integrated

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Andrej Mitrovic
On 3/11/14, Dicebot pub...@dicebot.lv wrote: I don't like the very concept of comments integrated with the docs and can't accept PHP example as authority. It just feels very intrusive Yeah, at some point there will be so many comments on a single page that it defeats the purpose. Comments

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Andrei Alexandrescu
On 3/11/14, 6:55 AM, Ivan Kazmenko wrote: http://dlang.org/library Looks nice! I second the opinion that Disqus might have a better alternative. Its loading after the page was rendered looks clumsy, its style does not match that of dlang.org's... the whole thing is somehow out of place.

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Steven Schveighoffer
On Tue, 11 Mar 2014 11:12:51 -0400, Andrei Alexandrescu seewebsiteforem...@erdani.org wrote: On 3/11/14, 6:55 AM, Ivan Kazmenko wrote: http://dlang.org/library Looks nice! I second the opinion that Disqus might have a better alternative. Its loading after the page was rendered looks

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Andrej Mitrovic
On 3/10/14, Andrei Alexandrescu seewebsiteforem...@erdani.org wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 I think on pages where we provide a cheat-sheet like in std.algorithm it's

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Andrei Alexandrescu
On 3/11/14, 8:52 AM, Andrej Mitrovic wrote: On 3/10/14, Andrei Alexandrescu seewebsiteforem...@erdani.org wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 I think on pages where we provide

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Jacob Carlborg
On 2014-03-11 16:52, Andrej Mitrovic wrote: I think on pages where we provide a cheat-sheet like in std.algorithm it's probably a good idea to remove the auto-generated list of functions, because it's essentially a duplicated list (and the cheat-sheet is better because it's humanly organized):

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Vladimir Panteleev
On Tuesday, 11 March 2014 at 15:38:21 UTC, Steven Schveighoffer wrote: On Tue, 11 Mar 2014 11:12:51 -0400, Andrei Alexandrescu seewebsiteforem...@erdani.org wrote: On 3/11/14, 6:55 AM, Ivan Kazmenko wrote: http://dlang.org/library Looks nice! I second the opinion that Disqus might have a

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Vladimir Panteleev
On Monday, 10 March 2014 at 22:50:54 UTC, Vladimir Panteleev wrote: On Monday, 10 March 2014 at 22:28:11 UTC, Nick Sabalausky wrote: On 3/10/2014 11:08 AM, Andrei Alexandrescu wrote: On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available?

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Andrei Alexandrescu
On 3/11/14, 10:38 AM, Jacob Carlborg wrote: On 2014-03-11 16:52, Andrej Mitrovic wrote: I think on pages where we provide a cheat-sheet like in std.algorithm it's probably a good idea to remove the auto-generated list of functions, because it's essentially a duplicated list (and the

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Steven Schveighoffer
On Tue, 11 Mar 2014 13:41:23 -0400, Vladimir Panteleev vladi...@thecybershadow.net wrote: On Tuesday, 11 March 2014 at 15:38:21 UTC, Steven Schveighoffer wrote: An idea -- would it be possible to search links from the D forum, and post underneath the discussions that link to that doc page?

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Piotr Szturmaj
W dniu 2014-03-10 04:44, Andrei Alexandrescu pisze: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library Great! Altough, I would exchange title order to like std.xxx module

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Jacob Carlborg
On 2014-03-11 19:03, Andrei Alexandrescu wrote: Yes to that. I seem to recall we have something similar on the homepage. Could you please get something started to serve as a pattern to follow for all of us? Do you mean how to write Ddoc comments or implement the $(CATEGORY) macro? -- /Jacob

Re: ddox-generated Phobos documentation is available for review

2014-03-11 Thread Andrei Alexandrescu
On 3/11/14, 12:08 PM, Jacob Carlborg wrote: On 2014-03-11 19:03, Andrei Alexandrescu wrote: Yes to that. I seem to recall we have something similar on the homepage. Could you please get something started to serve as a pattern to follow for all of us? Do you mean how to write Ddoc comments

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Philpax
Fantastic! The organization makes it easy to find the right tool for the job. This is probably nitpicking, but in std.algorithm and other modules ( http://dlang.org/library/std/algorithm.html ) there are multiple overloads of the same function (splitter, reverse, etc); it'd be nice if these

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Peter Alexander
On Monday, 10 March 2014 at 03:44:54 UTC, Andrei Alexandrescu wrote: http://dlang.org/library Looking good! The module list current shows deeply nested modules (e.g. std.c.stdio) before less nested ones (std.stdio). I think it should be the other way round, otherwise you have all the

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Dmitry Olshansky
10-Mar-2014 07:44, Andrei Alexandrescu пишет: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library http://dlang.org/library-prerelease I needed to change quite a bit about

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Nicolas Sicard
On Monday, 10 March 2014 at 03:44:54 UTC, Andrei Alexandrescu wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library http://dlang.org/library-prerelease I needed to

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread John Colvin
On Monday, 10 March 2014 at 03:44:54 UTC, Andrei Alexandrescu wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library http://dlang.org/library-prerelease I needed to

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Jonas Drewsen
Very nice! std.algorithm, std.net.curl etc. have their functions/classes split in categories. I haven't used ddox myself but would it be possible to modify it to read a category variable in the documentation for a function and then use that to group things in the resulting html file? Or

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Steven Schveighoffer
On Sun, 09 Mar 2014 23:44:43 -0400, Andrei Alexandrescu seewebsiteforem...@erdani.org wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. I LOVE this. Been waiting for it for a long time. The cross-links themselves are worth the wait. Just look

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Dicebot
On Monday, 10 March 2014 at 03:44:54 UTC, Andrei Alexandrescu wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library http://dlang.org/library-prerelease I needed to

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Mike
Thank you, to everone who worked on this. It's quite an improvement. Problem: http://dlang.org/library/std/compiler/vendor.html is a 404 Recommendation: I really liked the immediate link to the source file on github in the old layout. If possible please add it to the new layout. Mike

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Vladimir Panteleev
On Monday, 10 March 2014 at 14:08:07 UTC, Mike wrote: Thank you, to everone who worked on this. It's quite an improvement. Problem: http://dlang.org/library/std/compiler/vendor.html is a 404 Recommendation: I really liked the immediate link to the source file on github in the old layout.

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Andrei Alexandrescu
On 3/10/14, 1:35 AM, Nicolas Sicard wrote: For me it's a real improvement! One thing: symbol names (modules, functions, etc.) shouldn't be hyphenated, specially in tables. All: how does one turn off css hyphenation? Andrei

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Andrei Alexandrescu
On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available? Documentation in general may probably benefit from some styling tweaks - for example, std.alogrithm looks funny when manually crafted tables turn into usual generated function list. But

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread ralex
On Monday, 10 March 2014 at 14:56:13 UTC, Andrei Alexandrescu wrote: On 3/10/14, 1:35 AM, Nicolas Sicard wrote: For me it's a real improvement! One thing: symbol names (modules, functions, etc.) shouldn't be hyphenated, specially in tables. All: how does one turn off css hyphenation? Andrei

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Brad Anderson
On Monday, 10 March 2014 at 14:56:13 UTC, Andrei Alexandrescu wrote: On 3/10/14, 1:35 AM, Nicolas Sicard wrote: For me it's a real improvement! One thing: symbol names (modules, functions, etc.) shouldn't be hyphenated, specially in tables. All: how does one turn off css hyphenation? Andrei

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Brad Anderson
On Monday, 10 March 2014 at 14:11:06 UTC, Vladimir Panteleev wrote: On Monday, 10 March 2014 at 14:08:07 UTC, Mike wrote: Thank you, to everone who worked on this. It's quite an improvement. Problem: http://dlang.org/library/std/compiler/vendor.html is a 404 Recommendation: I really liked

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Vladimir Panteleev
On Monday, 10 March 2014 at 16:54:37 UTC, Brad Anderson wrote: On Monday, 10 March 2014 at 14:11:06 UTC, Vladimir Panteleev wrote: On Monday, 10 March 2014 at 14:08:07 UTC, Mike wrote: Thank you, to everone who worked on this. It's quite an improvement. Problem:

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Sönke Ludwig
Am 10.03.2014 15:11, schrieb Vladimir Panteleev: On Monday, 10 March 2014 at 14:08:07 UTC, Mike wrote: Thank you, to everone who worked on this. It's quite an improvement. Problem: http://dlang.org/library/std/compiler/vendor.html is a 404 Recommendation: I really liked the immediate link to

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread w0rp
The documentation is looking very good, good work to all involved. There are a few bugs here and there. Appender's docs were missing, some runtime modules are in there which should maybe be hidden. Still, this is a massive improvement, and I love it.

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Vladimir Panteleev
On Monday, 10 March 2014 at 18:56:41 UTC, Sönke Ludwig wrote: Am 10.03.2014 15:11, schrieb Vladimir Panteleev: On Monday, 10 March 2014 at 14:08:07 UTC, Mike wrote: Thank you, to everone who worked on this. It's quite an improvement. Problem:

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Nick Sabalausky
On 3/10/2014 11:08 AM, Andrei Alexandrescu wrote: On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available? Yea, forum.dlang.org ;) And anything else that doesn't completely and totally break without JS.

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Mike
On Monday, 10 March 2014 at 18:56:41 UTC, Sönke Ludwig wrote: It's actually already there - at the top of each page, there is a View source code button that goes to the proper file/line and to the proper branch/tag. I've used the same style as the already existing buttons, but those are indeed

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Vladimir Panteleev
On Monday, 10 March 2014 at 22:28:11 UTC, Nick Sabalausky wrote: On 3/10/2014 11:08 AM, Andrei Alexandrescu wrote: On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available? Yea, forum.dlang.org ;) And anything else that doesn't completely

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Andrei Alexandrescu
On 3/10/14, 3:28 PM, Nick Sabalausky wrote: On 3/10/2014 11:08 AM, Andrei Alexandrescu wrote: On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available? Yea, forum.dlang.org ;) And anything else that doesn't completely and totally break

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Vladimir Panteleev
On Monday, 10 March 2014 at 22:56:04 UTC, Andrei Alexandrescu wrote: On 3/10/14, 3:28 PM, Nick Sabalausky wrote: On 3/10/2014 11:08 AM, Andrei Alexandrescu wrote: On 3/10/14, 7:00 AM, Dicebot wrote: I still don't like disqus :) Are there better such systems available? Yea,

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Brad Roberts
A key required (imho) feature, the ability to edit after the fact. The primary value that I see in any sort of embedded user input feature is the the most streamlined way of adding essentially bug reports about the page directly on the page. Those reports should be acted upon and the page

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Andrei Alexandrescu
On 3/10/14, 4:04 PM, Vladimir Panteleev wrote: It's still on my list... sorry it's taking this long. You're the only one who requested this feature, though. I can think of several improvements (some of which are in the pipeline) which I think would be more useful to the community overall, but if

Re: ddox-generated Phobos documentation is available for review

2014-03-10 Thread Vladimir Panteleev
On Monday, 10 March 2014 at 23:16:40 UTC, Brad Roberts wrote: A key required (imho) feature, the ability to edit after the fact. The primary value that I see in any sort of embedded user input feature is the the most streamlined way of adding essentially bug reports about the page directly on

ddox-generated Phobos documentation is available for review

2014-03-09 Thread Andrei Alexandrescu
Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library http://dlang.org/library-prerelease I needed to change quite a bit about the makefile. It was building everything over

Re: ddox-generated Phobos documentation is available for review

2014-03-09 Thread Rikki Cattermole
I have to say its looking good. Although it does show just how much we need to break things up and make it a little bit more organised. Great example is the digest modules.

Re: ddox-generated Phobos documentation is available for review

2014-03-09 Thread Suliman
I very like how Tango docs organized http://www.dsource.org/projects/tango/docs/stable/ Also good example how docs organized http://devdocs.io

Re: ddox-generated Phobos documentation is available for review

2014-03-09 Thread Brad Anderson
On Monday, 10 March 2014 at 03:44:54 UTC, Andrei Alexandrescu wrote: Consider it alpha quality. Please don't announce yet before we put it in good shape. https://github.com/D-Programming-Language/dlang.org/pull/516 http://dlang.org/library http://dlang.org/library-prerelease I needed to