[DELTASPIKE-13] Choose documentation format and tools

• Type: Task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.3-incubating
• Assignee: Jason Porter
• Reporter: Shane Bryzak
• Created: 15/Dec/11 22:38
• Updated: 24/Aug/12 18:54
• Resolved: 15/Jul/12 17:28

Description

We need to decide on a documentation format for the DeltaSpike documentation. Requirements are:

1. Kept in the VCS with the DeltaSpike codebase
2. Buildable with Maven
3. Can generate multiple formats, including HTML and PDF

Currently the "industry standard" is DocBook, however there may be other alternatives which are more suitable. Suggestions welcome here.