> 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.
The numbers are problematic because you usually do not keep the order, and then after a time it is difficult to find a non-used number. The auto-toc creates the anchors from the text of the section which is nice if the question is short, but otherwise makes the URLs too long. Maybe we should do it by hand, but using some short text as the anchor instead of a numer. E.g. "How is TurboGears licensed? Can I use it for commercial applications?", then the anchor would be "license". > 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: That's true. > Or maybe we have to think about reverting to wiki syntax for the FAQ. The problem with this is that the rest of the Docu is in ReST format as far as I see. May be confusing to switch from one syntax to the other. -- Chris --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
