[phobos] Initial Phobos style guide proposal

Jonathan M Davis jmdavisProg at gmx.com
Thu Mar 31 11:06:37 PDT 2011


On 2011-03-31 10:57, Brad Roberts wrote:
> On 3/31/2011 10:55 AM, Andrei Alexandrescu wrote:
> > On 3/31/11 12:25 PM, Jonathan M Davis wrote:
> >> On 2011-03-31 09:10, Steve Schveighoffer wrote:
> >>> Maybe the comment style is bikeshedding, but definitely the placement
> >>> of comments always starting on the leftmost column affects the ability
> >>> to read the code for me.
> >> 
> >> I would point out that the example code needs to go all the way to the
> >> left, otherwise the examples get indented in the generated docs.
> >> However, I agree that the ddoc comments themselves not being indented
> >> is annoying.
> > 
> > Yah, forgot about that argument. I'm not sure where this leaves us.
> > 
> > Andrei
> 
> Improving ddoc.  You guys seem to be treating it as some sort of
> unchangable thing.  If it doesn't behave the way we need it to, pull up
> the code and whack it a bit.

What do you think we are? Software developers? ;)

- Jonathan M Davis


More information about the phobos mailing list