geomacy commented on a change in pull request #284: Add Dockerfile to build the
website with docker
URL: https://github.com/apache/brooklyn-docs/pull/284#discussion_r274593316
##########
File path: README.md
##########
@@ -101,23 +119,16 @@ to generate a site in `_site` without a server.
This does <i>not</i> generate API docs and certain other material;
see the notes on `_build/build.sh` below for that.
+### Using docker
-Project Structure
------------------
-
-Note that there are two interlinked micro-sites in this project:
+Run the following command
-* `/website`: this contains the main Brooklyn website, including committer
instructions,
- download instructions, and "learn more" pages;
- this content has **only one instance** on the live website,
- and as changes are published they replace old content
-
-* `/guide`: this contains the user guide and information pertaining to a
- specific Brooklyn version, including code structure and API documentation;
- the live website contains a **copy of the guide for each Brooklyn version**,
- with the code coming from the corresponding branch in `git`
+```sh
+docker run -it --rm -v ${PWD}:/usr/workspace -w /usr/workspace -p4000:4000
brooklyn-docs-website "bundle install && ./_build/build.sh website-root --serve"
Review comment:
`brooklyn:doc-website` rather than `brooklyn-docs-website`
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
