Hi,

I've been looking at our in-project maven site documentation, and I see
that it's using markdown. Quick question: does the build system support
reStructured Text too? I know it should support Asciidoc, according to [0]
(which should probably be removed, to discourage new Asciidoc
documentation) so it's probably just a matter of putting the right content
in the right place, but I couldn't find any references to reStructuredText
at [1] (and the Asciidoc support was ODL in-house). How complicated would
it be for the support to be added, if it's not there yet?

I'm asking because I think it should be easy to migrate docs from a project
to docs. Something that starts out as a few notes here and there may grow
into something that may be useful to be added to the Developer/User Guides.
Or, those Guides could be generated using content from a project's Maven
Sites documentation.

I'm pretty sure this has already been discussed, and I missed it, so sorry
for the noise.

-Lori

[0]
https://nexus.opendaylight.org/content/sites/site/org.opendaylight.odlparent/carbon/asciidoc-in-site.html
[1]
https://maven.apache.org/plugins/maven-site-plugin/examples/creating-content.html
_______________________________________________
Discuss mailing list
[email protected]
https://lists.opendaylight.org/mailman/listinfo/discuss

Reply via email to