Lack of a strict formatting style for XML

Alexandre Vassalotti avassalotti at gmail.com
Thu Mar 30 20:39:46 UTC 2006


While editing the documentation, I remarked a lack of style
consistence in the DocBook source files. For example, check
how the <para> tags are indented.

I propose that we append a indentation style into the
Styleguide. Then, we could distribute a list settings for different
text editors. (ie. Emacs and VIM) Just like Linux did with their
Coding Style. This would ensure the readability and ease the
maintaining of the documents.

Along this, a list of the commonly used DocBook tags with a example
for each would be greatly appreciated by new writers. This would make
the DocBook format more accessible and would encourage a consistent
style in the sources.

--
Alex V.




More information about the ubuntu-doc mailing list