[Gllug] LinuxDoc / DocBook Documentation Writting

[Peter Childs]

I like the idea of LinuxDoc and DocBook for writting documentation,
The theory is wonderful, however I hit some major problems. Event
strict XHTML has the same theory.

DTDs are long complicated documents written in some weird language
nobody quite understands them, which makes learning them for non
teches impossible.

The Only editor for LinuxDoc or DocBook is Vi or Emacs so you have to
try and remember the nessessary structure and its up to you to check
your spelling and grammer many features that are built in to the likes
of OpenOffice and Word which work well with WYSIWYG languages.

In short I want a wysiwyg editor for a language that does not care
about format and layout.

Ideally if somone changes the font size it goes in the style sheet and
sections they set to be the same will get marked up simulally of text
should look the same.

That way change style sheet and content stays the same (structully),
In short you can write you content get it write then send it to your
design person and they can mess around with the style sheet and get it
into the nessessary look, That way all titles look the same and one
does not get missed on the 22nd page..... (I've seen that happen too
often)

The problem is that programmers can't write good documentation because
they use the wrong language but you don't want to have to technically
train your documenation writters becuase then they will be too
technical when they come to write the doc.....

Now if somone can't tell me that somthing of this nature already
exsists I will write myself it but its going to feel like reinventing
the wheel.

Peter.
-- 
Gllug mailing list  -  Gllug at gllug.org.uk
http://lists.gllug.org.uk/mailman/listinfo/gllug