Tilmann Zäschke created JDO-779:
-----------------------------------
Summary: Migrate JDO Homepage / Online Documentation
Key: JDO-779
URL: https://issues.apache.org/jira/browse/JDO-779
Project: JDO
Issue Type: Improvement
Components: site and infrastructure
Reporter: Tilmann Zäschke
Assignee: Tilmann Zäschke
The homepage and online documentation is currently generated from xdoc (Maven 1
doc format), located in the SVN 'site' repo. Te homepage and documentation
should be migrated to a more modern format, such as markdown, and moved to a
new repo.
Initial investigation:
* The only xdoc converter I found is
[Doxia|http://maven.apache.org/doxia/doxia-tools/doxia-converter/]. I don't
really know all the output formats, but one option may by (x)html. This maybe
useful because there exist many html to markdown converters.
* If we use 'html' as intermediate stage, it probably makes sense to directly
migrate the html version of the home page to markdown.
* There are many thml to markdown converters, such as [this PHP command line
converter|https://github.com/thephpleague/html-to-markdown].
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
