[Home]

Summary:ASTERISK-11600: [patch] asciidoc documentation
Reporter:Tzafrir Cohen (tzafrir)Labels:
Date Opened:2008-03-08 16:49:57.000-0600Date Closed:2011-06-07 14:03:07
Priority:MajorRegression?No
Status:Closed/CompleteComponents:Documentation
Versions:Frequency of
Occurrence
Related
Issues:
Environment:Attachments:( 0) asciidoc.diff
( 1) asterisk-asciidoc.html
Description:Attached a patch that demonstrates the use of asciidoc for Asterisk documentation.

The new documentation currently only includes zapata.conf and the CODING-GUILINES. the CODING-GUIDELINES have been completely converted to the new format. The sample zapata.conf demonstrates having a structured reference configuration file. This should hopefully also allow referencing configuration items from elsewhere.

****** ADDITIONAL INFORMATION ******

asterisk-asciidoc.html is the generated output. You need to download it and view it locally due to the Mantis' presentation of attachments.
Comments:By: Jason Parker (jparker) 2008-04-11 15:06:08

What do we want to do with this?  Was there any consensus on the -dev list about this?

By: Russell Bryant (russell) 2008-06-03 15:06:24

I'm suspending this for now, as this is not the place for discussion.

I really don't care what markup format we use.  To change to something else, you'll have to:

1) Get a majority consensus on the -dev list that it's a worthwhile change

2) Be willing to do the mass conversion

3) Do the mass conversion

All of which should be done before something is posted here