On Wednesday, 21 January 2015 at 15:35:59 UTC, Chris wrote:
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"
Yeah, alot of stuff needs some fine-tuning. Specially the fonts.
Content is just copy-n-paste, could definitely use some marketing.
