GEODE-1952 Move docs build README; edit build instructions

Project: http://git-wip-us.apache.org/repos/asf/incubator-geode/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-geode/commit/a0de4c93
Tree: http://git-wip-us.apache.org/repos/asf/incubator-geode/tree/a0de4c93
Diff: http://git-wip-us.apache.org/repos/asf/incubator-geode/diff/a0de4c93

Branch: refs/heads/feature/GEODE-1952-3
Commit: a0de4c93f53dc51b1b1ca3489c66f3f8e0a62fa3
Parents: d573de2
Author: Joey McAllister <jmcallis...@pivotal.io>
Authored: Fri Oct 14 12:13:15 2016 -0700
Committer: Karen Miller <kmil...@pivotal.io>
Committed: Fri Oct 14 14:51:04 2016 -0700

----------------------------------------------------------------------
 geode-book/README.md     | 61 ++++++++++++++++++++++++++++++++++++++++++-
 geode-docs/CONTRIBUTE.md |  8 +++---
 geode-docs/README.md     | 53 -------------------------------------
 3 files changed, 63 insertions(+), 59 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/a0de4c93/geode-book/README.md
----------------------------------------------------------------------
diff --git a/geode-book/README.md b/geode-book/README.md
index a1c1602..198becc 100644
--- a/geode-book/README.md
+++ b/geode-book/README.md
@@ -1 +1,60 @@
-For information about writing, editing, building, and publishing the Apache 
Geode documentation, please view the `README.md` and `CONTRIBUTING.md` files in 
the `geode-docs` directory.
\ No newline at end of file
+# Apache Geode End-User Documentation
+
+Apache Geode provides the full source for end-user documentation in markdown 
format (see `../geode-docs/CONTRIBUTE.md`). The latest check-ins to 
`incubator-geode/geode-docs` are regularly built and published to 
http://geode.incubator.apache.org/docs/. Users can build the markdown into an 
HTML user guide using [Bookbinder](https://github.com/pivotal-cf/bookbinder) 
and the instructions below.
+
+Bookbinder is a Ruby gem that binds  a unified documentation web application 
from markdown, html, and/or DITA source material. The source material for 
bookbinder must be stored either in local directories or in GitHub 
repositories. Bookbinder runs [middleman](http://middlemanapp.com/) to produce 
a Rackup app that can be deployed locally or as a Web application.
+
+This document contains instructions for building and viewing the Geode 
documentation locally.
+
+- [Prerequisites](#prerequisites)
+- [Bookbinder Usage](#bookbinder-usage)
+- [Building the Documentation](#building-the-documentation)
+
+## Prerequisites
+
+Bookbinder requires Ruby version 2.0.0-p195 or higher.
+
+Follow the instructions below to install Bookbinder:
+
+1. Add gem "bookbindery" to your Gemfile.
+2. Run `bundle install` to install the dependencies specified in your Gemfile.
+
+## Bookbinder Usage
+
+Bookbinder is meant to be used from within a project called a **book**. The 
book includes a configuration file that describes which documentation 
repositories to use as source materials. Bookbinder provides a set of scripts 
to aggregate those repositories and publish them to various locations.
+
+For Geode, a preconfigured **book** is provided in the directory `geode-book`, 
which gathers content from the directory `geode-docs`. You can use this 
configuration to build HTML for Geode on your local system.
+
+The installed `config.yml` file configures the Geode book for building 
locally. The file configures the local directory for the markdown source files.
+
+## Building the Documentation
+
+1. The GemFile in the `geode-book` directory already defines the `gem 
"bookbindery"` dependency. Make sure you are in the `geode-book` directory and 
enter:
+
+```
+  $ bundle install
+```
+
+   Note: You will not have to run `bundle install` on subsequent builds.
+
+2. To build the documentation locally using the installed `config.yml` file, 
enter:
+
+```
+  $ bundle exec bookbinder bind local
+```
+   Bookbinder converts the markdown source into HTML, which it puts in the 
`final_app` directory.
+
+3. Navigate to the `geode-book/final_app/` and enter:
+
+  ```
+  $ bundle install
+  ```
+   Note: You will not have to run `bundle install` on subsequent builds.
+
+4. To start the website locally, enter:
+
+  ```
+  $ rackup
+  ```
+
+   You can now view the local documentation at <http://localhost:9292>. 
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/a0de4c93/geode-docs/CONTRIBUTE.md
----------------------------------------------------------------------
diff --git a/geode-docs/CONTRIBUTE.md b/geode-docs/CONTRIBUTE.md
index 979474e..8ff2502 100644
--- a/geode-docs/CONTRIBUTE.md
+++ b/geode-docs/CONTRIBUTE.md
@@ -6,6 +6,8 @@ Apache Geode welcomes your contributions to the community's 
documentation effort
 - [Working with Images and Graphics](#working-with-images-and-graphics)
 - [Writing Guidelines](#writing-guidelines)
 
+For instructions on building the documentation locally, see 
`../geode-book/README.md`.
+
 ## Working with Markdown Files
 
 You can edit markdown files in any text editor. For more, read [Daring 
Fireball's Markdown Syntax 
page](https://daringfireball.net/projects/markdown/syntax).
@@ -23,13 +25,9 @@ The Wikipedia page [Comparison of Vector Graphics 
Editors](http://en.wikipedia.o
 The most important advice we can provide for working with the Apache Geode 
docs is to spend some time becoming familiar with the existing source files and 
the structure of the project directory. In particular, note the following 
conventions and tips:
 
 - Top-level subdirectories organize topics into "books": basic_config, 
configuring, developing, etc.
-
 - Use lowercase characters for all file and directory names. Separate words in 
filenames with an underscore (`_`) character.
-
 - Use the `.md` file extension for topic files.
-
 - Add new topics to the existing directories by subject type. Only create a 
new directory if you are starting a new subject or a new book.
-
 - To start a new topic, you can make a copy of an existing file with similar 
content and edit it.
-
 - Use the appropriate document type for the content you are writing. Create 
multiple topics if you are writing overview, procedural, and reference content.
+- To edit elements in the navigation pane (the "subnav") that appears on the 
left side of the documentation, navigate to 
`../geode-book/master_middleman/source/subnavs/geode-subnav.md`.

http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/a0de4c93/geode-docs/README.md
----------------------------------------------------------------------
diff --git a/geode-docs/README.md b/geode-docs/README.md
deleted file mode 100644
index 9fb5870..0000000
--- a/geode-docs/README.md
+++ /dev/null
@@ -1,53 +0,0 @@
-# Apache Geode End-User Documentation
-
-Apache Geode provides the full source for end-user documentation in markdown 
format. The latest check-ins to `incubator-geode/geode-docs` are regularly 
built and published to http://geode.incubator.apache.org/docs/. Users can build 
the markdown into an HTML user guide using 
[Bookbinder](https://github.com/pivotal-cf/bookbinder) and the instructions 
below.
-
-Bookbinder is a Ruby gem that binds  a unified documentation web application 
from markdown, html, and/or DITA source material. The source material for 
bookbinder must be stored either in local directories or in GitHub 
repositories. Bookbinder runs [middleman](http://middlemanapp.com/) to produce 
a Rackup app that can be deployed locally or as a Web application.
-
-This document contains instructions for building and viewing the Geode 
documentation locally.
-
-- [Prerequisites](#prerequisites)
-- [Bookbinder Usage](#bookbinder-usage)
-- [Building the Documentation](#building-the-documentation)
-
-## Prerequisites
-
-Bookbinder requires Ruby version 2.0.0-p195 or higher.
-
-Follow the instructions below to install Bookbinder:
-
-1. Add gem "bookbindery" to your Gemfile.
-2. Run `bundle install` to install the dependencies specified in your Gemfile.
-
-## Bookbinder Usage
-
-Bookbinder is meant to be used from within a project called a **book**. The 
book includes a configuration file that describes which documentation 
repositories to use as source materials. Bookbinder provides a set of scripts 
to aggregate those repositories and publish them to various locations.
-
-For Geode, a preconfigured **book** is provided in the directory `geode-book`, 
which gathers content from the directory `geode-docs`. You can use this 
configuration to build HTML for Geode on your local system.
-
-The installed `config.yml` file configures the Geode book for building 
locally. The file configures the local directory for the markdown source files.
-
-## Building the Documentation
-
-1. The GemFile in the `geode-book` directory already defines the `gem 
"bookbindery"` dependency. Make sure you are in the `geode-book` directory and 
enter:
-
-  ```
-  $ bundle install
-  ```
-
-2. To build the files locally using the installed `config.yml` file, enter:
-
-  ```
-  $ bundle exec bookbinder bind local
-  ```
-
-  Bookbinder converts the markdown source into HTML, which it puts in the 
`final_app` directory.
-
-3. To view the local documentation, do the following:
-
-  ```
-  $ cd final_app
-  $ rackup
-  ```
-
-  You can now view the local documentation at <http://localhost:9292>.

Reply via email to