You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@apex.apache.org by vr...@apache.org on 2016/08/29 21:30:27 UTC
apex-site git commit: Fix documentation deployment steps.
Repository: apex-site
Updated Branches:
refs/heads/master 2639c0c9a -> 693634e99
Fix documentation deployment steps.
Project: http://git-wip-us.apache.org/repos/asf/apex-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/apex-site/commit/693634e9
Tree: http://git-wip-us.apache.org/repos/asf/apex-site/tree/693634e9
Diff: http://git-wip-us.apache.org/repos/asf/apex-site/diff/693634e9
Branch: refs/heads/master
Commit: 693634e990794c42e19fa046ccb26116becee278
Parents: 2639c0c
Author: Thomas Weise <th...@datatorrent.com>
Authored: Mon Aug 29 14:12:21 2016 -0700
Committer: Thomas Weise <th...@datatorrent.com>
Committed: Mon Aug 29 14:12:21 2016 -0700
----------------------------------------------------------------------
src/md/release.md | 17 +++++++++--------
1 file changed, 9 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/apex-site/blob/693634e9/src/md/release.md
----------------------------------------------------------------------
diff --git a/src/md/release.md b/src/md/release.md
index a5ad9b0..669a06a 100644
--- a/src/md/release.md
+++ b/src/md/release.md
@@ -152,8 +152,13 @@ svn import svn-dist https://dist.apache.org/repos/dist/dev/apex/${RNAME}-RC1 -m
## Build and Deploy Documentation
-The documentation will be generated as static HTML files and copied into the `apex-site` repository. It will be available at an alternate URL path until the release is promoted, at which time it will also be promoted to the main website location.
+The documentation will be generated as static HTML files into the `apex-site` repository, [separated by version (X.Y)](https://github.com/apache/apex-site/tree/asf-site/docs).
+**Note** You need Python 2.7+ and [mkdocs](http://www.mkdocs.org/) with patch for issue [mkdocs #859](https://github.com/mkdocs/mkdocs/issues/859) on top of the currently available version 0.15.3. After installing mkdocs with pip, run the following to obtain this build:
+
+```
+sudo pip install --upgrade git+https://github.com/sashadt/mkdocs.git
+```
Do the following setup steps before building and deploying the documentation.
1. Clone the apex-site repository into a folder called ```apex-site``` at the same level as the current repository.
@@ -176,10 +181,10 @@ Do the following setup steps before building and deploying the documentation.
The `REPO_NAME` variable above should match the folder name of the cloned apex module being built.
-To build and deploy the documentation, execute the following commands in the apex module folder specified in `REPO_NAME` above. **Note**: Until [mkdocs #859](https://github.com/mkdocs/mkdocs/issues/859) is resolved and available for download, use mkdocs built against [master](https://github.com/mkdocs/mkdocs).
+Build and deploy the documentation in the release directory:
```bash
-# build docs, they would be generated in a site sub-folder
+# build docs in ${REPO_NAME}, they will be generated in a site sub-folder
mkdocs build --clean
# Calculate the major.minor version
@@ -195,11 +200,7 @@ git commit -m "Adding ${DOC_NAME}-${rv} documentation"
git push
```
-The documentation is now accessible at the URL location below. For patch releases, however, the documentation changes will already reflect on the website.
-
-```
-https://apex.apache.org/docs/${DOC_NAME}-${docv}/
-```
+After [publishing the site](https://github.com/apache/apex-site/tree/master#contributing) the new documentation will be available at `https://apex.apache.org/docs/${DOC_NAME}-${docv}/`
## Voting