On Wednesday, 21 January 2015 at 14:46:22 UTC, Sebastiaan Koppe
wrote:
Just for fun and proof-of-concept I went ahead and forked the
dlang.org site. I basically took the
`do-what-everybody-else-is-doing` approach:
http://dlang.skoppe.eu
It is still a wip, but the landing page and the language
reference (see Docs menu-item) is working.
Doing the ddoc was a maze of macro's at first. But spending a
couple of hours untangling the mess, I finally found the ones I
needed to change. After that things went pretty smooth. So ddoc
ain't that bad. It is just that I didn't have syntax
highlighting - nor goto-definition - and I hate that.
Still, it is cool in a way that I can just change some macro's,
tweak the index.dd, the doc.ddoc and don't have to worry about
all the other pages.
BTW, the build process on windows was way easier than linux. In
fact, I could not get the makefile to run on linux at all.
Looking into posix.mak, I see a blur of path's, all
misconfigured, and I bet I am supposed to set those manually. I
don't get it, doesn't everything has its own place? Isn't dmd
always installed in /usr/bin, /usr/include/dmd and that stuff?
I suppose not everyone is using the same distro. Or they are,
except me :)
Good start. A few points:
1. The font is too big (see also 2.).
2. A lot of space is wasted. To fix this, maybe it would help to
lay it out in "tiles" (two or three items in one row, cf
http://foundation.zurb.com/).
As it is now, the three major points Convenience, Power and
Efficiency are too far apart, there's too much scrolling involved
(which users hate). All the important information should be
visible at once.
3. No need to use so much space for "The D Programming Language",
especially since we don't have a fancy graphic to fill that space
(why should we).
4. Tools like DUB etc. should be bundled as on the Foundation
homepage under something like "Build products, apps and services"