Mike Percy created KUDU-2506:
--------------------------------

             Summary: Improve and document docs push procedure
                 Key: KUDU-2506
                 URL: https://issues.apache.org/jira/browse/KUDU-2506
             Project: Kudu
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 1.7.1
            Reporter: Mike Percy


As of this writing, when we want to push docs for a release, the release docs 
will overwrite the existing "unversioned" docs. This is a problem for 
maintenance releases, such as releasing a 1.5.1 after a 1.6.0 release, since 
the unversioned 1.6.0 docs living at [http://kudu.apache.org/docs/] will be 
replaced with 1.5.1 docs.

We should improve this process and the scripts that drive it. Potential 
improvements:
 * Add an option to the docs publish script to only update the versioned docs, 
i.e. --versioned-only
 * Separate out master vs versioned docs push into separate script invocations
 * Create a Jenkins job that can build and deploy docs to either /docs or a 
release docs location.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to