On Wednesday, 21 January 2015 at 17:10:09 UTC, Sebastiaan Koppe
wrote:
On Wednesday, 21 January 2015 at 16:30:37 UTC, Andrei
Alexandrescu wrote:
This is awesome, and something I'd get behind. Here's a little
feedback coming from a self-admitted dilettante:
* On my laptop it looks like this: http://imgur.com/v8TC1xq.
I'm seeing the red menu at the top, the gray sparse box, and
also an odd fragment of the next page which has a different
background, a title, and a fragment of code snippet. The way I
look at it is either you go balls-out with the sparse gray
page and make it occupy the entire viewport, or you make it
smaller to allow me to get to some content. As things are I
can't stop wondering: "Why did they waste all that space so I
can't see stuff?"
(...)
* Generally I feel I must scroll too much through too little
(and occasionally crappy - not your fault) content on the
homepage. There's just so much "air". But that might be part
of the page's very look and feel, so if people like it no
problem.
Agreed. Again, it is a proof-of-concept.
* Page doesn't seem to load on mobile at all.
Hmm, that is odd. Some other people said the same thing. Loads
fine on mine though...
* Clicking on "Overview" while I'm on the homepage does
nothing. But there's no visual indication I'm already on
"Overview". Also clicking on "Overview" or the logo seem to do
the same thing. Oh, wait, not all menus are meant to work -
take that back.
There are no navigational helpers indeed. Didn't know how to
get the current page from within ddoc to set css stuff to
highlight things etc.
* There's no accordion on "Language Reference" which makes for
a really tall menu, sometimes even longer than the content
itself. I find that hard to navigate. Statistically nobody
will get to "Visual D" and "Community" :o).
Haha. There are some other pages as well that nobody gets to
read in full.
* Layout is jerky as I reduce the width of the page: sometimes
the right/left margins are really wide, even on thin
viewports, thus wasting already precious space, then they get
thin, then they get wide again, etc.
There is a mismatch between some responsive stuff. Saw it as
well. It's just about playing with thresholds, and alot of
tweaking.
You should have no trouble building dlang.org on linux
following the instructions at
https://github.com/D-Programming-Language/dlang.org/blob/master/CONTRIBUTING.md.
Will look into it.
The rationale for NOT using /usr/bin/dmd etc. is that
oftentimes the docs use specific features of the compiler,
which means you need to build a specific library docs with the
same compiler version. For the site proper we always use the
development version of dmd (which by default we assume is
../dmd/src/dmd) so people can change the compiler and the docs
in tandem. Once you get that in place things should work
smoothly.
Yeah, but where can I get /dmd/src/dmd? Do I need to fork the
dmd source code?
Sebastian, could please you publish your fork somewhere so we
could take a closer look and/or fork/destroy it? It would also be
easier to make specific suggestions
