Recent changes to Ubuntu
Sean Wheller
sean at inwords.co.za
Thu Apr 7 11:41:57 UTC 2005
On Thursday 07 April 2005 13:45, Jerome Gotangco wrote:
> In the chat room with Corey, he has some really nice ideas on
> integrating the whole documentation procedure whatever is the end
> product (wiki, docbook, etc.) in a logical way that all users,
> especially the new ones will have to read. It's not nice when reading
> yelp that when I find a page in the manual that tells me what to do,
> but i have to read it elsewhere and is not included in the current
> manual. This is especially so for people who migrate from another os
> or distribution.
Yes I currently have two systems in eval in my lab:
Docbook Wiki
Apache Lenya
>
> At the moment, we do have an awesome collection of docs but like what
> Sean hass pointed out, everything is so decentralized at the moment.
> In my former job, where I did some technical writing in an ISO
> setting, the method of doing the manual should be documented, as well
> as the history of the said document. I believe this is possible in our
> current setting - we do need a cohesive system that allows us to have
> proper audit trails as well as document history. The end result of
> these documents are collected in a Documentation Masterlist that we
> all refer to. I'm sure our current system is capable of such, we just
> have to create proper procedures.
Yes, we did try get a formal process some time ago, but people were not in
favor. Their point of view is that doing documentation would stop being fun.
If people are interested and want to support such an initiative I will make
the policy document. However, I would not like to go this effort and then
nobody follows it.
--
Sean Wheller
Technical Author
sean at inwords.co.za
084-854-9408
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/20050407/41754de8/attachment.pgp>
More information about the ubuntu-doc
mailing list