Re: Our docs should be more beautiful

2016-07-26 Thread Robert burner Schadek via Digitalmars-d
** RANT ON ** A perfect example for an item for your action list. And it pretty much looks like the syntax the wiki is using already. I bet you a drink at next years DConf that it will take you at least 10 minutes to find and reread this thread next time you create a vision document just to

Re: Our docs should be more beautiful

2016-07-21 Thread w0rp via Digitalmars-d
I like this kind of discussion. It's good to make the website look as attractive and functional as we can make it. I think we just need to remember to file each issue individually, then group all of the issues to track all of them. Then each individual issue can be tackled, and some work can

Re: Our docs should be more beautiful

2016-07-21 Thread Charles Hixson via Digitalmars-d
I think the Python docs looks better and are more useful...but the older Python docs were even better. Sometimes fancier HTML just makes things less useful. That said, I think that when feasible docs should be auto-generated from code included within the code files. More like ddoc or

Re: Our docs should be more beautiful

2016-07-19 Thread Wyatt via Digitalmars-d
On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: * My pet dream was to work on a project with a beautiful justified and hyphenated website. After endless debates, ugliness has won - I'm looking at a eye-scratching ragged right edge. I just want to point out that Firefox

Re: Our docs should be more beautiful

2016-07-19 Thread bitwise via Digitalmars-d
On Tuesday, 19 July 2016 at 17:02:34 UTC, Andrei Alexandrescu wrote: On 7/19/16 12:39 PM, bitwise wrote: On Tuesday, 19 July 2016 at 01:37:20 UTC, Andrei Alexandrescu wrote: On 07/18/2016 06:13 PM, bitwise wrote: Any chance of getting one definition or overload-set per page? Been like that

Re: Our docs should be more beautiful

2016-07-19 Thread Andrei Alexandrescu via Digitalmars-d
On 7/19/16 12:39 PM, bitwise wrote: On Tuesday, 19 July 2016 at 01:37:20 UTC, Andrei Alexandrescu wrote: On 07/18/2016 06:13 PM, bitwise wrote: Any chance of getting one definition or overload-set per page? Been like that for a while, my comments refer to the old styling. -- Andrei Why

Re: Our docs should be more beautiful

2016-07-19 Thread bitwise via Digitalmars-d
On Tuesday, 19 July 2016 at 01:37:20 UTC, Andrei Alexandrescu wrote: On 07/18/2016 06:13 PM, bitwise wrote: Any chance of getting one definition or overload-set per page? Been like that for a while, my comments refer to the old styling. -- Andrei Why talk about the old style though? I

Re: Our docs should be more beautiful

2016-07-19 Thread Mattcoder via Digitalmars-d
On Tuesday, 19 July 2016 at 01:38:54 UTC, Andrei Alexandrescu wrote: ... http://i.imgur.com/UTLpK42.png PS: Click to see the full image. I like the styling on the right - the vertical spacing between paragraph is ridiculous in the left version, and the "Jump to:" box is too tall. -- Andrei

Re: Our docs should be more beautiful

2016-07-19 Thread qznc via Digitalmars-d
On Monday, 18 July 2016 at 22:24:09 UTC, Adam D. Ruppe wrote: The ddox ones are supposed to be made default eventually. What is the state on this? I found no issue tracking this.

Re: Our docs should be more beautiful

2016-07-18 Thread Andrei Alexandrescu via Digitalmars-d
On 07/18/2016 09:43 PM, Andrei Alexandrescu wrote: On 07/18/2016 11:56 AM, Andrei Alexandrescu wrote: I was proofreading

Re: Our docs should be more beautiful

2016-07-18 Thread Andrei Alexandrescu via Digitalmars-d
On 07/18/2016 11:56 AM, Andrei Alexandrescu wrote: I was proofreading http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/phobos-prerelease/std_experimental_checkedint.html and there are a few ways in which our docs could

Re: Our docs should be more beautiful

2016-07-18 Thread Andrei Alexandrescu via Digitalmars-d
On 07/18/2016 09:28 PM, Carl Vogel wrote: Racket's docs have actually been designed by a professional typographer, so might be a good reference point. Example: https://docs.racket-lang.org/reference/flonums.html They do look nice! -- Andrei

Re: Our docs should be more beautiful

2016-07-18 Thread Andrei Alexandrescu via Digitalmars-d
On 07/18/2016 06:16 PM, Mattcoder wrote: On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: I was proofreading

Re: Our docs should be more beautiful

2016-07-18 Thread Andrei Alexandrescu via Digitalmars-d
On 07/18/2016 06:13 PM, bitwise wrote: Any chance of getting one definition or overload-set per page? Been like that for a while, my comments refer to the old styling. -- Andrei

Re: Our docs should be more beautiful

2016-07-18 Thread Carl Vogel via Digitalmars-d
On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: I was proofreading http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/phobos-prerelease/std_experimental_checkedint.html and there are a few ways in

Re: Our docs should be more beautiful

2016-07-18 Thread bitwise via Digitalmars-d
On Monday, 18 July 2016 at 22:24:09 UTC, Adam D. Ruppe wrote: On Monday, 18 July 2016 at 22:13:35 UTC, bitwise wrote: Any chance of getting one definition or overload-set per page? Both the ddox pages at /library and my pages at dpldocs.info do it this way. The ddox ones are supposed to be

Re: Our docs should be more beautiful

2016-07-18 Thread Adam D. Ruppe via Digitalmars-d
On Monday, 18 July 2016 at 22:13:35 UTC, bitwise wrote: Any chance of getting one definition or overload-set per page? Both the ddox pages at /library and my pages at dpldocs.info do it this way. The ddox ones are supposed to be made default eventually.

Re: Our docs should be more beautiful

2016-07-18 Thread Mattcoder via Digitalmars-d
On Monday, 18 July 2016 at 22:16:45 UTC, Mattcoder wrote: On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: I was proofreading

Re: Our docs should be more beautiful

2016-07-18 Thread Mattcoder via Digitalmars-d
On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: I was proofreading http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/phobos-prerelease/std_experimental_checkedint.html and there are a few ways in

Re: Our docs should be more beautiful

2016-07-18 Thread bitwise via Digitalmars-d
On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: I was proofreading http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/phobos-prerelease/std_experimental_checkedint.html and there are a few ways in

Re: Our docs should be more beautiful

2016-07-18 Thread qznc via Digitalmars-d
On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: I was proofreading http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/phobos-prerelease/std_experimental_checkedint.html and there are a few ways in

Re: Our docs should be more beautiful

2016-07-18 Thread Jacob Carlborg via Digitalmars-d
On 2016-07-18 17:56, Andrei Alexandrescu wrote: * My pet dream was to work on a project with a beautiful justified and hyphenated website. I hate when words are split between rows. -- /Jacob Carlborg

Re: Our docs should be more beautiful

2016-07-18 Thread Brad Anderson via Digitalmars-d
On Monday, 18 July 2016 at 17:09:57 UTC, Kagamin wrote: Do we see the same thing? I see ugly justified hyphenated text https://abload.de/img/tmpr5ow8.png It's hyphenated on browsers that support it. The chrome team is very close to supporting hyphenation so it'll soon be justified in all the

Re: Our docs should be more beautiful

2016-07-18 Thread Lodovico Giaretta via Digitalmars-d
On Monday, 18 July 2016 at 17:09:57 UTC, Kagamin wrote: Do we see the same thing? I see ugly justified hyphenated text https://abload.de/img/tmpr5ow8.png It probably depends on the browser. Mine shows the text not justified, and it does not try to break words (while your does). Probably, the

Re: Our docs should be more beautiful

2016-07-18 Thread Kagamin via Digitalmars-d
Do we see the same thing? I see ugly justified hyphenated text https://abload.de/img/tmpr5ow8.png

Re: Our docs should be more beautiful

2016-07-18 Thread Seb via Digitalmars-d
On Monday, 18 July 2016 at 16:18:27 UTC, Jack Stouffer wrote: On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: * "0 Contributors" should not be displayed at the bottom if there are no contributors. But I assume that's only the case before the pull is merged? Yeah, should

Re: Our docs should be more beautiful

2016-07-18 Thread Jack Stouffer via Digitalmars-d
On Monday, 18 July 2016 at 15:56:29 UTC, Andrei Alexandrescu wrote: * My pet dream was to work on a project with a beautiful justified and hyphenated website. After endless debates, ugliness has won - I'm looking at a eye-scratching ragged right edge. Please, no more debates on this. The

Our docs should be more beautiful

2016-07-18 Thread Andrei Alexandrescu via Digitalmars-d
I was proofreading http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/phobos-prerelease/std_experimental_checkedint.html and there are a few ways in which our docs could look better. * My pet dream was to work on a