[Date Prev][Date Next][Thread Prev][Thread Next]
[Date Index]
[Thread Index]
- Subject: Re: LuaDoc
- From: steve donovan <steve.j.donovan@...>
- Date: Tue, 29 Mar 2011 08:42:04 +0200
On Tue, Mar 29, 2011 at 3:44 AM, Matthew Frazier
<leafstormrush@gmail.com> wrote:
> Being able to
> write docs in Markdown would be better.
Oh yes, having HTML tags in comments is ugly and very 20th century.
> - Its reliance on API documentation rather than narrative documentation.
> This makes it hard to explain complex topics.
This is a hard one, because finding a good organization for
documentation is not easy; the tool should provide suitable templates?
If Markdown was allowed, then long module preambles would not be such
a pain to write.
steve d.