List Info

Thread: Re: What documentation style should we use?




Re: What documentation style should we use?
user name
2007-05-18 16:21:56
On 18.05.07 16:05:11, Matthew Woehlke wrote:
> While working on the VCS Interfaces I've noticed a
couple different 
> styles for documentation, specifically some sentences
end with periods, 
> some don't, some things have initial capitals, some
don't. Is there a 
> set of rules we should be following for this? I would
have thought 
> "English sentences", meaning always
capitalize and always end with a 
> period...?

fine with me. If comments from me are lacking either please
fix or tell
me. Especially I tend to forget the period at the end of
sentences. Its
nothing that I meant to do that wasy, I just forget it 

Andreas

-- 
Among the lucky, you are the chosen one.

_______________________________________________
KDevelop-devel mailing list
KDevelop-develkdevelop.org
https://barney.cs.uni-potsdam.de/mailman/listinf
o/kdevelop-devel

Re: What documentation style should we use?
country flaguser name
United States
2007-05-18 17:00:57
Andreas Pakulat wrote:
> On 18.05.07 16:05:11, Matthew Woehlke wrote:
>> While working on the VCS Interfaces I've noticed a
couple different 
>> styles for documentation, specifically some
sentences end with periods, 
>> some don't, some things have initial capitals, some
don't. Is there a 
>> set of rules we should be following for this? I
would have thought 
>> "English sentences", meaning always
capitalize and always end with a 
>> period...?
> 
> fine with me. If comments from me are lacking either
please fix or tell
> me. Especially I tend to forget the period at the end
of sentences. Its
> nothing that I meant to do that wasy, I just forget it


No worries, no rush... at some point I expect to basically
do a 
proofreading pass over the VCS-Iface docs. I can clean
things up then, I 
just want to make sure I'm cleaning up the right way.

-- 
Matthew
Excessive obscurity: -5


_______________________________________________
KDevelop-devel mailing list
KDevelop-develkdevelop.org
https://barney.cs.uni-potsdam.de/mailman/listinf
o/kdevelop-devel

[1-2]

about | contact  Other archives ( Real Estate discussion Medical topics )