Re: A few notes on the ddox-based documentation

2017-03-23 Thread Sönke Ludwig via Digitalmars-d
Am 05.03.2017 um 02:47 schrieb Andrei Alexandrescu: * For some reason tables have the wrong penalties set up because they hyphenate type names in their left column (e.g. Pro-erCom-pare) which makes all tables look comically bad. https://github.com/dlang/dlang.org/pull/1613

Re: A few notes on the ddox-based documentation

2017-03-23 Thread Sönke Ludwig via Digitalmars-d
Am 05.03.2017 um 02:47 schrieb Andrei Alexandrescu: Was just looking over these: https://dlang.org/library-prerelease/std/experimental/checkedint.html https://dlang.org/phobos-prerelease/std_experimental_checkedint.html http://dpldocs.info/experimental-docs/std.experimental.checkedint.html Ther

Re: A few notes on the ddox-based documentation

2017-03-05 Thread Adam D. Ruppe via Digitalmars-d
On Sunday, 5 March 2017 at 01:47:24 UTC, Andrei Alexandrescu wrote: http://dpldocs.info/experimental-docs/std.experimental.checkedint.html * There's code coloring in inline code, which is a bit distracting. Syntax highlighting should be ideally limited to code blocks. I just tried removing

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Jack Stouffer via Digitalmars-d
On Sunday, 5 March 2017 at 01:47:24 UTC, Andrei Alexandrescu wrote: The ddox documentation with its page-per-artifact approach Still not sold on this :/ I guess it comes down to preference, but I don't see the advantage of splitting up the docs across a ton of different pages. I've also en

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Adam D. Ruppe via Digitalmars-d
On Sunday, 5 March 2017 at 04:26:01 UTC, Seb wrote: https://github.com/dlang/phobos/pull/5185/commits/c092ce4fcd9e9a45961c41cf44676e76319b9c14 Ah, I actually commented on that one too! Yeah, neither $(D) or `` is desired on those. LREF alone should do it. (or $(D) alone does it on ddox and ad

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Seb via Digitalmars-d
On Sunday, 5 March 2017 at 03:38:49 UTC, Andrei Alexandrescu wrote: On 3/4/17 10:19 PM, Adam D. Ruppe wrote: $(D $(LREF Abort))) A great point, yah this should be never encountered. A referenced symbol is always in code font. Where's the PR? :O) -- Andrei On the closed list, e.g.: https:/

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Adam D. Ruppe via Digitalmars-d
On Sunday, 5 March 2017 at 03:13:46 UTC, Andrei Alexandrescu wrote: A pull request for "the competition" would be very much appreciated! https://github.com/dlang/dlang.org/pull/1600 that should be an improvement, though I didn't actually test it... is there an online preview for that?

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Andrei Alexandrescu via Digitalmars-d
On 3/4/17 10:19 PM, Adam D. Ruppe wrote: $(D $(LREF Abort))) A great point, yah this should be never encountered. A referenced symbol is always in code font. Where's the PR? :O) -- Andrei

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Adam D. Ruppe via Digitalmars-d
On Sunday, 5 March 2017 at 03:14:14 UTC, Adam D. Ruppe wrote: So it illegally nested a link inside a link, which the browser interpreted as two adjacent links... and both got that padding-right from the rule I quoted in my last email, thus getting some blank space on the first row. On second

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Adam D. Ruppe via Digitalmars-d
On Sunday, 5 March 2017 at 01:47:24 UTC, Andrei Alexandrescu wrote: * For some reason tables have the wrong penalties set up because they hyphenate type names in their left column (e.g. Pro-erCom-pare) which makes all tables look comically bad. I see what happened here too: ddox detected "Abor

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Andrei Alexandrescu via Digitalmars-d
On 3/4/17 10:01 PM, Adam D. Ruppe wrote: Yeah, I am coming around to agree with you on that too. Best. Sentence. Written. In. A. Forum. Ever. This is a css bug: table.book tbody a { padding-right: .6em; } Firefox tells me it is `style.css` line 1,000. Surely the intent of that was to pa

Re: A few notes on the ddox-based documentation

2017-03-04 Thread Adam D. Ruppe via Digitalmars-d
On Sunday, 5 March 2017 at 01:47:24 UTC, Andrei Alexandrescu wrote: * There's code coloring in inline code, which is a bit distracting. Syntax highlighting should be ideally limited to code blocks. Yeah, I am coming around to agree with you on that too. I have been playing with my highlight c

A few notes on the ddox-based documentation

2017-03-04 Thread Andrei Alexandrescu via Digitalmars-d
Was just looking over these: https://dlang.org/library-prerelease/std/experimental/checkedint.html https://dlang.org/phobos-prerelease/std_experimental_checkedint.html http://dpldocs.info/experimental-docs/std.experimental.checkedint.html There are a few issues I found with the ddox-based librar