http://www.digitalmars.com/d/2.0/dstyle.html

http://lists.puremagic.com/pipermail/phobos/2010-August/001757.html

Actually, that style guide in there generally looks pretty good, but perhaps people don't know it is there?

What might be a good idea is a kind of "welcome package" to Phobos sent to new developers, including these links, links explaining how dsource svn works, and other general information.

With all that stuff in one place, it'll be easier for newbies to keep track of it all. I just now started a page for this purpose:

http://dpldocs.info/phobos-developers.html

  On 16.08.2010 00:04, Adam Ruppe wrote:
> Actually, that style guide in there generally looks pretty good, but perhaps people don't know it is there?
>
> What might be a good idea is a kind of "welcome package" to Phobos sent to new developers, including these links, links explaining how dsource svn works, and other general information.
>
> With all that stuff in one place, it'll be easier for newbies to keep track of it all. I just now started a page for this purpose:
>
> http://dpldocs.info/phobos-developers.html
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos
>

Looking through the source, you can see what developer has written what
code.
It's better to let a source control system do that instead of the coding
style.
At many parts in the source it's easy to identify who wrote what.

It feels like a mad coincidence that this gets addressed now (just my
posts. There are probably more):
  * http://stackoverflow.com/questions/3480363/d-phobos-style-guide
  *
http://www.digitalmars.com/d/archives/digitalmars/D/learn/D_style_guide_21098.html

It's not that it's difficult to read the source, but it's easier to read a consistent codebase.

I'll stay out of the discussion now as I'm really new to D, phobos and really much everything.. :|

Yeah, I'll admit that I'm guilty of accidentally letting my own style seep into code, but lately I've been making an effort to look at the code immediately surrounding whatever I'm working on and make the style at least locally consistent.  This sometimes makes me feel schitzophrenic if I hack several modules in a short time period.

On 8/15/2010 6:34 PM, Simen Endsj? Haugen wrote:
>  On 16.08.2010 00:04, Adam Ruppe wrote:
>> Actually, that style guide in there generally looks pretty good, but perhaps people don't know it is there?
>>
>> What might be a good idea is a kind of "welcome package" to Phobos sent to new developers, including these links, links explaining how dsource svn works, and other general information.
>>
>> With all that stuff in one place, it'll be easier for newbies to keep track of it all. I just now started a page for this purpose:
>>
>> http://dpldocs.info/phobos-developers.html
>> _______________________________________________
>> phobos mailing list
>> phobos at puremagic.com
>> http://lists.puremagic.com/mailman/listinfo/phobos
>>
>
> Looking through the source, you can see what developer has written
> what code.
> It's better to let a source control system do that instead of the
> coding style.
> At many parts in the source it's easy to identify who wrote what.
>
> It feels like a mad coincidence that this gets addressed now (just my
> posts. There are probably more):
>  * http://stackoverflow.com/questions/3480363/d-phobos-style-guide
>  *
> http://www.digitalmars.com/d/archives/digitalmars/D/learn/D_style_guide_21098.html
>
>
> It's not that it's difficult to read the source, but it's easier to read a consistent codebase.
>
> I'll stay out of the discussion now as I'm really new to D, phobos and really much everything.. :|
>
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos
>

I would add to the documentation section that except public declarations also all protected declarations should be documented.

On 15 aug 2010, at 21:48, Walter Bright wrote:

> http://www.digitalmars.com/d/2.0/dstyle.html
> 
> http://lists.puremagic.com/pipermail/phobos/2010-August/001757.html
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos

Okay, I put this older suggestion of yours on my todo list.

Andrei

On 8/15/10 14:48 CDT, Walter Bright wrote:
> http://www.digitalmars.com/d/2.0/dstyle.html
>
> http://lists.puremagic.com/pipermail/phobos/2010-August/001757.html
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos