couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dave Cottlehuber (JIRA)" <j...@apache.org>
Subject [jira] [Created] (COUCHDB-1787) Automate release process documentation
Date Thu, 02 May 2013 15:12:16 GMT
Dave Cottlehuber created COUCHDB-1787:
-----------------------------------------

             Summary: Automate release process documentation
                 Key: COUCHDB-1787
                 URL: https://issues.apache.org/jira/browse/COUCHDB-1787
             Project: CouchDB
          Issue Type: Improvement
          Components: Build System, Documentation
            Reporter: Dave Cottlehuber


The release process today contains a large number of manual transformation steps.

Fixing this will make the release process significantly easier for release managers, as well
as less error-prone.

Ideally the output formats (NEWS, CHANGES in source tree, and HTML snippets for http://couchdb.org/
website and http://blogs.apache.org/couchdb ) can be auto-generated from either the .rst files
in share/doc/src using sphinx's .versionaddded/changed tags, or potentially from commit messages
if this is appropriate.

CouchDB documentation is generated today from restructured text using python code, and rolled
into the release documentation during `make distcheck`.


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message