[overlord-issues] [JBoss JIRA] (SRAMP-74) Create documentation process

Create documentation process ---------------------------- Key: SRAMP-74 URL: https://issues.jboss.org/browse/SRAMP-74 Project: S-RAMP Issue Type: Task Security Level: Public(Everyone can see) Affects Versions: Milestone 2 (Properties) Reporter: Kurt Stam Assignee: Kurt Stam Fix For: Milestone 4 I'm thinking about creating the content using MarkDown (md) format. Github's wiki supports this format and the docs end up as *md files in a github project. This means that we can work on documentation while being offline, and users can alter the docs in their fork and send us pull requests. At release time we use a tool like pandoc to convert the md files to docbook format. The docbook files should be checked in with the S-RAMP project itself. We can then put these docbook based files out on jboss.org.