Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id D904D200BC7 for ; Sat, 15 Oct 2016 00:17:21 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id D7A74160AE3; Fri, 14 Oct 2016 22:17:21 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id EE729160AF7 for ; Sat, 15 Oct 2016 00:17:20 +0200 (CEST) Received: (qmail 38703 invoked by uid 500); 14 Oct 2016 22:17:20 -0000 Mailing-List: contact commits-help@geode.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@geode.incubator.apache.org Delivered-To: mailing list commits@geode.incubator.apache.org Received: (qmail 38549 invoked by uid 99); 14 Oct 2016 22:17:20 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 14 Oct 2016 22:17:20 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id B855DC0244 for ; Fri, 14 Oct 2016 22:17:19 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -6.219 X-Spam-Level: X-Spam-Status: No, score=-6.219 tagged_above=-999 required=6.31 tests=[KAM_ASCII_DIVIDERS=0.8, KAM_LAZY_DOMAIN_SECURITY=1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-2.999] autolearn=disabled Received: from mx1-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id VRQCOvtyFFXs for ; Fri, 14 Oct 2016 22:17:17 +0000 (UTC) Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx1-lw-eu.apache.org (ASF Mail Server at mx1-lw-eu.apache.org) with SMTP id 835F360E5E for ; Fri, 14 Oct 2016 22:17:04 +0000 (UTC) Received: (qmail 35947 invoked by uid 99); 14 Oct 2016 22:17:02 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 14 Oct 2016 22:17:02 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 7C74FDFB78; Fri, 14 Oct 2016 22:17:02 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: kmiller@apache.org To: commits@geode.incubator.apache.org Date: Fri, 14 Oct 2016 22:18:25 -0000 Message-Id: In-Reply-To: <4e5a8ffd52f143b79e70b1717c3838a1@git.apache.org> References: <4e5a8ffd52f143b79e70b1717c3838a1@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [87/94] [abbrv] incubator-geode git commit: GEODE-1952 Add book README; edit docs README, CONTRIBUTE archived-at: Fri, 14 Oct 2016 22:17:22 -0000 GEODE-1952 Add book README; edit docs README, CONTRIBUTE Project: http://git-wip-us.apache.org/repos/asf/incubator-geode/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-geode/commit/0b312759 Tree: http://git-wip-us.apache.org/repos/asf/incubator-geode/tree/0b312759 Diff: http://git-wip-us.apache.org/repos/asf/incubator-geode/diff/0b312759 Branch: refs/heads/release/1.0.0-incubating Commit: 0b31275966beaf4039afd913b8644c81a32c1758 Parents: 36d1f39 Author: Joey McAllister Authored: Tue Oct 11 17:29:12 2016 -0700 Committer: Joey McAllister Committed: Tue Oct 11 17:29:12 2016 -0700 ---------------------------------------------------------------------- geode-book/README.md | 1 + geode-docs/CONTRIBUTE.md | 10 +++++----- geode-docs/README.md | 9 +-------- 3 files changed, 7 insertions(+), 13 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/0b312759/geode-book/README.md ---------------------------------------------------------------------- diff --git a/geode-book/README.md b/geode-book/README.md new file mode 100644 index 0000000..a1c1602 --- /dev/null +++ b/geode-book/README.md @@ -0,0 +1 @@ +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 http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/0b312759/geode-docs/CONTRIBUTE.md ---------------------------------------------------------------------- diff --git a/geode-docs/CONTRIBUTE.md b/geode-docs/CONTRIBUTE.md index dd97f47..7345cb3 100644 --- a/geode-docs/CONTRIBUTE.md +++ b/geode-docs/CONTRIBUTE.md @@ -12,10 +12,10 @@ Project Geode welcomes your contributions to the community's documentation effor We use the fork-and-pull collaboration method on GitHub: -1. In your GitHub account, fork the gemfire/docs-geode-md repository. +1. In your GitHub account, fork the `apache/incubator-geode` repository. 2. Create a local clone of your fork. -3. Make changes and commit them in your fork. -4. In the gemfire/docs-geode-md repository, create a pull request. +3. Make changes in the `geode-docs` directory and commit them in your fork. +4. In the `apache/incubator-geode` repository, create a pull request. See [Using Pull Requests](https://help.github.com/articles/using-pull-requests/) on GitHub for more about the fork-and-pull collaboration method. @@ -23,7 +23,7 @@ See [Using Pull Requests](https://help.github.com/articles/using-pull-requests/) ## Document Source Files and Tools -Project Geode documentation source files are written in markdown. Image files include .gif and .png graphics and editable image files in the open source SVG format. +Project Geode documentation source files are written in markdown. Image files include .gif and .png graphics and editable image files in the open-source SVG format. - [Working with Markdown Files](#markdown) - [Working with Images and Graphics](#images) @@ -38,7 +38,7 @@ You can edit markdown files in any text editor. For more, read [Daring Fireball' ### Working with Images and Graphics -Image files in .gif or .png format are in the `images` directory in the Project Geode docs repo. Images in .svg format are in the `images_svg` directory. +Image files in .gif or .png format are in the `docs/images` directory in the Project Geode docs repo. Images in .svg format are in the `docs/images_svg` directory. Most of the Project Geode image files have been converted to the open source SVG format. You can insert SVG images directly into an XML topic and modify images using a SVG editor. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/0b312759/geode-docs/README.md ---------------------------------------------------------------------- diff --git a/geode-docs/README.md b/geode-docs/README.md index bc70325..199906e 100644 --- a/geode-docs/README.md +++ b/geode-docs/README.md @@ -4,12 +4,11 @@ Apache Geode provides the full source for end-user documentation in markdown for Bookbinder is a 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, as well as for publishing it to the Geode website. It contains the sections: +This document contains instructions for building and viewing the Geode documentation locally. - [Prerequisites](#prereq) - [Bookbinder Usage](#usage) - [Building the Documentation](#building) -- [Publishing the Documentation](#publishing) ## Prerequisites @@ -75,9 +74,3 @@ broken_link_exclusions: iefix|using_custom_classes|arrowhead|cppdocs|DotNetDocs ``` You can now view the local documentation at . - -## Publishing the Documentation - -Because the `final_app` directory contains the full output of the HTML conversion process, you can easily publish this directory as a hosted Web application. - -To publish the Geode documentation you built locally to the Geode website, move the contents of the directory `geode-book/final_app/public/docs` to the directory `geode-site/website/content/docs`. Then, follow the instructions for updating the website located at `geode-site/website/README.md`. \ No newline at end of file