[phobos] Initial Phobos style guide proposal

Brad Roberts braddr at puremagic.com
Thu Mar 31 10:57:05 PDT 2011


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.


More information about the phobos mailing list