Re: Documentation Guidelines?

["Gavin Henry" <ghenry@suretecsystems.com>]

<quote who="Howard Chu">
> Gavin Henry wrote:
>> Dear all,
>>
>> I was asked by Quanah to review a commit he did at:
>>
>> http://www.openldap.org/devel/cvsweb.cgi/admin/slapdconf2.sdf.diff?r1=1.28&r2=1.29&cvsroot=OpenLDAP-guide&hideattic=1&sortbydate=0&f=h
>>
>> And all looks well, but I want to query if we have or want some brief
>> Doc
>> Guidelines drafted?
>>
>> For example, some covering what we do and don't {{EX:}}, capitalisation,
>> various tags we use etc.
>>
>> Thoughts?
>
> No idea, other than "some recognizable convention would be nice." The
> same question applies to the manpages.

Yeah, something like "New developers go to this page for contribution
guidelines/styles, New doc contributors follow this guide" etc.

Need to have browse and see what people have been sticking to.

Gavin.

>
> --
>    -- Howard Chu
>    Chief Architect, Symas Corp.  http://www.symas.com
>    Director, Highland Sun        http://highlandsun.com/hyc
>    OpenLDAP Core Team            http://www.openldap.org/project/
>