On 2 March 2010 09:01, Daniel Holbach <[email protected]> wrote: > On 02.03.2010 00:01, Emmet Hikory wrote: >> 4) The majority of our fellow developers are probably not familiar >> with mallard. While they can learn how to use it, it seems >> unfortunate to make this change at the same time we are making other >> changes that require developers to update their understanding: >> frequent change of the way in which things are done has often been >> cited in the past as a reason for developers to cease contributions. > > Before we decide to do this it might make sense to talk to people who > did this work in DocBook before and how many people enjoyed contributing > there. > > I don't mean to be too negative and am happy about every attempt to > spruce up our documentation, but I have some reservations about the ease > of doing drive-by fixes or writing a new article. > > Have a great day, > Daniel
I have worked a little bit on improving user documentation using DocBook and Mallard. Mallard is not your typical docbook nightmare. It's very lightweight and for me was easier than wiki markup ;-) Although I would also suggest RESTructured text ala python documentation ;-) -- Ubuntu-motu mailing list [email protected] Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-motu
