On Tuesday, 10 February 2015 at 21:00:11 UTC, H. S. Teoh wrote:
This PR:
https://github.com/D-Programming-Language/phobos/pull/2973
introduces a code example with 2-space indentation, whereas the
rest of
Phobos and dlang.org uses 4-space indentation.
I don't like this. It's inconsistent, and is detracting from the
professional look of D. It's bad enough that we are
inconsistent from
one page to another, it's even worse that this PR introduces a
style
inconsistency within a *single* doc page. It makes D look
amateurish and
unprofessional.
Walter's reason for this is that 4-space indentation makes it
look bad
on Kindle and other small-screen readers. Which is a good
point, but it
shouldn't be reason for inconsistent code style throughout
dlang.org.
If we decide that 4-space indentation is no good, then we
should switch
*wholesale* to whatever it is we deem good. We should not be
introducing
arbitrary style differences on an ad hoc basis.
So, what will it be? What coding style should we use for
official
language docs? Should we use 4-space indentation or 2-space
indentation?
Should we reduce the maximum line length in code samples so
that they
don't look horribly on narrow-width readers? Or something else
altogether?
(Note also, that the code example in question is part of a
ddoc'd
unittest, which means it is also inconsistent with the rest of
Phobos
code. This is a smaller issue than inconsistency in
public-facing docs,
but nonetheless, it's an annoying one.)
T
I hate 2-space tabs as much as I hate 8-space tabs.
