Karl Guertin schrieb:
> MoinMoin compatibility issues aside (which I do need to look into) I
> have no problems with rest.

I think that rest is sometimes very cumbersome[1], unintuitive and
inconsistent[2] but I can live with it and I would not want to convert all the
pages we have yet again.

> - Rest is more standard than moin syntax, which is an advantage if we
> wind up changing doc tools/wikis in the future

I use rest all the time for project documentation, just because there are many
tools to convert it to something else.

> - I plan on producing a documentation PDF, which rest facilitates

In theory yes, but in practice you would need to re-implement a good part of
the wiki logic, if we want to get intra-wiki links to work correctly in
standalone HTML/PDF versions.

> - We're already using it

Amen.


Chris

[1] examples: numbered lists, headings, any syntax that makes heavy usage of
angle brackets is a nightmare (esp. on German keyboards).

[2] Why are first-level unordered lists not indented, while other
block-constructs are?

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"TurboGears Docs" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/turbogears-docs?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to