[idea] round tripping

Sean Wheller sean at inwords.co.za
Mon Mar 14 09:13:34 UTC 2005


Hi,

Following Corey's suggestion to use a wiki from end for authoring I have been 
doing some research. The basic difference between our ideas was that I do not 
want replace docbook as the primary format for storage of ubuntu-docs. 
However, people do want an easy way to access and edit documents. As I said 
before, if we can round trip then I am +1 for a wiki front end.

The problem is how to enable web-based editing via a wiki-like front-end and 
still maintain the integrity of docbook documents in the repository and 
maintain the revision control we currently have.

So here is a partial solution. Partial only because it is not a fully finished 
application yet, but it looks promising.

http://doc-book.sourceforge.net/homepage/

Take a look at it and lets discuss it. Given the current stage of development 
for this system I don't see it as a short-term solution. However, it is worth 
keeping our eye on this. Naturally a move to such a solution would require 
integration with, or replacement of the current wiki for viewing and creating 
docs. 

This may be a good or bad thing.

Good because we can round trip and make everyone happy. We will also have 
better control over the structure.

Bad because the overhead in integration and the pain of being crash test 
dummies may be excruciating.

However, we may put it up somewhere experimental like docteam.ubuntu.com and 
see what we can do with it. I do believe if we can get a system like this and 
integration between svn and other systems such as Rossetta that we may have a 
winner.

Thoughts.

-- 
Sean Wheller
Technical Author
sean at inwords.co.za
http://www.inwords.co.za
Registered Linux User #375355
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20050314/378217bb/attachment.pgp>


More information about the ubuntu-doc mailing list