John Lavoie schrieb:
> As someone who is just starting to contribute documents and not having 
> any familiarity with *any* wiki syntax, I don't really care what markup 
> is used.  BUT I've been having a hard time figuring out what markup 
> works and what doesn't.  Does the docs site allow articles to be entered 
> as either syntax? 

You declare that a page is in rest format at the top of the page with

#format rst

otherwise it is in (MoinMoin) wiki format.

> Most of the formatting help pages on the docs site 
> aren't *quite* correct. 

All the documentation about editing on the wiki is about the wiki syntax, there
is only a short rest quickref included [1]. But you can always refer to the
main rest documentation [2].

> For instance the help box displayed on the 
> editing page, and the SyntaxReference.

They refer to the wiki syntax.

> Is someone aware of the inconsistencies or should I start documenting 
> the problems I am finding?

You could put them on http://docs.turbogears.org/DocTeam/BestPractices, but I
wouldn't bother about inconsistencies coming from the rest/wiki format
distinction. I might be good to say that you can use wiki format for
organisational pages.

Chris


[1] http://docs.turbogears.org/HelpOnParsers/ReStructuredText/RstPrimer
[2] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html

--~--~---------~--~----~------------~-------~--~----~
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