Chong Yu Meng wrote:


The docs are not FAQ worthy but definitely worth linking to from the FAQ.


Well, the documents weren't written to be a FAQ, and I think the structure does not lend itself well to a FAQ. The reason why I wrote it that way was because a lot of answers in FAQs assume or require a level of understanding that newbie Tomcat administrators may not possess. Instead of trying to cover the background and theory behind every question, I thought a "walk-through" tutorial would be a more effective way of building up understanding of the product.

100% Agree - Many times people go to any FAQ before using a product. Catching the newbies is the goal of linking from the FAQ. (That is, getting them to a tutorial like document)



Some people may be thinking this is kludgey. Yes it is. But I think its an OK tradeoff so we can keep the barrier of documentation creation low.

Here, here. But I need to say a little something about my documents. The original document is actually in Docbook format, and I generate the HTML from that document using docbook utilities. If you want to put it into the Wiki, you'll need only the HTML (without the masthead), am I right ? I've never used Wiki before, so I may need help here.


Wiki has its pros and cons. And different flavors of Wiki are more advanced in the their formatting capabilitites than others. You might be able to post straight HTML, but usually Wiki's don't like that.

TextFormattingRules: http://www.usemod.com/cgi-bin/wiki.pl?TextFormattingRules

-Tim




--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]



Reply via email to