[SCB-1884] Using Asciidoc to process the ServiceComb Pack docs

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: pack-0.7.0
• Assignee: Unassigned
• Reporter: Willem Jiang
• Created: 09/May/20 01:11
• Updated: 22/May/20 06:49

Description

Asciidoc has a handy tool chain to generate the HTML5 file as user manual. You can check out the example project I got recently.

Here are some sub tasks in my mind:
1. Translate current markdown files into Asciidoc files.
2. Setup the document project to leverage the maven asciidoc plugin to build the HTML5.
3. Update the distribution assembly file to generate the
4. (Optional) Integrate the document building and deployment with our CI system.