Ceylon pandoc converter for documentation

[formalizator]

Hi!

There is an idea to use pandoc for ceylondoc compilation. This tool allows to use markdown as it is and also allow user to use variety of standards for documentation.

In case of pandoc user is able to document some formulas like this:

This converter can also provide html pages for herd module and make cross links.

All the features we have now with markdown will stay the same. Pandoc is fully copatitable with md.

Another good feature will be custom modules for documentation.

To support this feature we should change compiler and IDE plugin.

[Tom Bentley]

To me this seems like quite a lot of work for relatively little benefit. Personally, I wouldn't want Ceylon to support a variety of standards for documentation (I assume that means a variety of syntaxes), because that would make the doc annotations harder to read than just supporting a single syntax.

--
You received this message because you are subscribed to the Google Groups "ceylon-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ceylon-dev+...@googlegroups.com.
To post to this group, send email to ceylo...@googlegroups.com.
Visit this group at https://groups.google.com/group/ceylon-dev.
To view this discussion on the web visit https://groups.google.com/d/msgid/ceylon-dev/fe13b264-f67c-42c3-83e9-931303ce1eec%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.