On 10/11/2014 05:45, Marvin Humphrey wrote:
The past proposal was to augment Markdown with JavaDoc-style @tags and
custom links. But now that there's a standard, I think we should abandon the
extensions so that we'll be able to say, simply, "Clownfish uses Markdown for
documentation".
Right now, we're using @param and @return tags a fair amount. I volunteer to
do the drudge work of turning those into ordinary Markdown.
Oh, I didn't want to get rid of the JavaDoc-style @tags. I really like the
originally proposed mixture of JavaDoc and Markdown as it adds some additional
structure to method documentation that can be used effectively when converting
to formats like HTML.
Nick
