I say we revert to wiki syntax for the faq, if that can make life easier.

The current method is combersome and will scare away new contributers.

--Mark

On 2/5/07, Christopher Arndt <[EMAIL PROTECTED]> wrote:
>
> Christoph Zwerschke schrieb:
> > Anyway, I think editing the FAQ is a bit cumbersome as it is now anyway,
>
> I agree, but I decided to pay that price, because:
>
> a) I want to keep the numbering of questions stable, so we can refer to them
> from outside the document and the references stay valid, even if the FAQ
> changes, the question gets moved around etc.
>
> > If we format the questions as subsection headers, we
> > could create a table of contents automatically with the ReST directive
> > ".. contents::" containing all the question. The only problem I see with
> > this is that the CSS for the ToC in the default theme is not very well
> > suited for this purpose.
>
> b) That is exactly why I didn't use section headers for the questions. I tried
> it and the auto generated TOC is ugly and useless in its present style.
>
> c) I find it very awkward to format a question that is longer than a line as a
> section header because you have to have a very long underline as well or
> otherwise you will get a warning message in your page:
>
> System Message: WARNING/2 (<string>, line ??)
>
> Title underline too short.
>
> > Maybe there is a way to overwrite the default
> > CSS for a specific page in MoinMoin?
>
> Or maybe we have to think about reverting to wiki syntax for the FAQ.
>
> I'm open to other, better solutions.
>
> Chris
>
> >
>


-- 
Mark Ramm-Christensen
email: mark at compoundthinking dot com
blog: www.compoundthinking.com/blog

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"TurboGears" 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?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to