[kde-doc-english]Style Guide

[Lauri Watts]

Hi all,

I've been doing a complete rewrite of the http://i18n.kde.org/doc/ website, 
rearranging the information to make it more accessible to new writers, and 
collating some of the pages where the same information is covered multiple 
times.

There's the basis of a good all round style guide already there, plus there is 
the entire markup guide already written, which I'll be reviewing at the same 
time.

My question to you all:
Would you rather I amalgamate all this information into one big "KDE 
Documentation Style Guide" covering both DocBook markup, and general writing 
style, or would you rather keep the markup guide as it is, covering just the 
technical side of the markup (but updated), and a separate style guide 
covering such topics as capitalisation, punctuation, preferred spelling, etc.

I see advantages in both, on the one hand having all this information in one 
single document gives a single point of reference, on the other hand, keeping 
the markup and other information separate makes it a lot easier to look up 
one or the other when you just want a quick answer.

-- 
Lauri Watts