reStructuredText

[Enrico Zini]

On Fri, Nov 26, 2004 at 10:43:11PM +0200, Sivan Green wrote:

> >Some documents which I originally wrote in moin have since been
> >converted to reStructuredText, and I find them difficult to maintain.
> >Has the documentation team standardized on reStructuredText?  If so,
> >can I beg you to reconsider, at least for simple wiki documents? :-)
> No need to beg on my account, I am already using MoinMoin for all my 
> wiki needs, this might be a good point to be brought on the next 
> documentation team meetin, when it's scheduled. (We're still finalizing 
> the times and date)

I think we already agreed on the last docteam meeting.  From the summary:

   Since ZWiki allows choosing different markup styles, we tried to see
   if there should be a wiki markup format of choice. Consensus was that
   the people active on a page are the ones that decide on its format. 

   The markup of bigger documents maintained outside of the wiki has
   instead been agreed to be DocBook-XML ( http://www.sagehill.net/docbookxsl/
   http://www.docbook.org/tdg/en/html/). ChrisH? offered to help with
   providing Docbook-XML templates and Makefiles

      (http://www.ubuntulinux.org/wiki/DocumentationTeamMeetingSummary2)

I second Matt's critics on reStructured text (although I see it's got
potential to represent more of the document structure, but then why not
docbook), I've tried reSt once and I'm personally using Moin for my
pages.


Ciao,

Enrico

--
GPG key: 1024D/797EBFAB 2000-12-05 Enrico Zini <enrico at enricozini.org>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20041126/ed3db138/attachment.pgp>