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 8D966200BBD for ; Tue, 25 Oct 2016 08:20:14 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 8C55C160B03; Tue, 25 Oct 2016 06:20:14 +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 AF147160B01 for ; Tue, 25 Oct 2016 08:20:13 +0200 (CEST) Received: (qmail 64663 invoked by uid 500); 25 Oct 2016 06:20:12 -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 64649 invoked by uid 99); 25 Oct 2016 06:20:12 -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; Tue, 25 Oct 2016 06:20:12 +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 679EBC0A91 for ; Tue, 25 Oct 2016 06:20:12 +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-us.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id L24YekB7AJad for ; Tue, 25 Oct 2016 06:20:10 +0000 (UTC) Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with SMTP id C4BBC60DD2 for ; Tue, 25 Oct 2016 06:20:09 +0000 (UTC) Received: (qmail 64417 invoked by uid 99); 25 Oct 2016 06:20:09 -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; Tue, 25 Oct 2016 06:20:09 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 541A6E02E4; Tue, 25 Oct 2016 06:20:09 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: sbawaskar@apache.org To: commits@geode.incubator.apache.org Date: Tue, 25 Oct 2016 06:20:51 -0000 Message-Id: <037e298c60f3435f93d75e6ec3b3c50d@git.apache.org> In-Reply-To: <72eff08b2f4d45f38b89f2a9d2e67e60@git.apache.org> References: <72eff08b2f4d45f38b89f2a9d2e67e60@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [45/50] [abbrv] incubator-geode git commit: GEODE-1952: Change Project G to Apache G; other edits archived-at: Tue, 25 Oct 2016 06:20:14 -0000 GEODE-1952: Change Project G to Apache G; other edits Project: http://git-wip-us.apache.org/repos/asf/incubator-geode/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-geode/commit/131e99ee Tree: http://git-wip-us.apache.org/repos/asf/incubator-geode/tree/131e99ee Diff: http://git-wip-us.apache.org/repos/asf/incubator-geode/diff/131e99ee Branch: refs/heads/master Commit: 131e99eeb7e2971f0aa51ffdf23624138cca5652 Parents: d8afffb Author: Joey McAllister Authored: Wed Oct 12 17:56:09 2016 -0700 Committer: Karen Miller Committed: Fri Oct 14 14:51:03 2016 -0700 ---------------------------------------------------------------------- geode-docs/CONTRIBUTE.md | 48 +++++++++---------------------------------- geode-docs/README.md | 2 +- 2 files changed, 11 insertions(+), 39 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/131e99ee/geode-docs/CONTRIBUTE.md ---------------------------------------------------------------------- diff --git a/geode-docs/CONTRIBUTE.md b/geode-docs/CONTRIBUTE.md index 7345cb3..979474e 100644 --- a/geode-docs/CONTRIBUTE.md +++ b/geode-docs/CONTRIBUTE.md @@ -1,54 +1,26 @@ -# Contributing to the Project Geode Documentation +# Contributing to the Apache Geode Documentation -Project Geode welcomes your contributions to the community's documentation efforts. You can participate by writing new content, reviewing and editing existing content, or fixing bugs. This document covers the following topics: +Apache Geode welcomes your contributions to the community's documentation efforts. You can participate by writing new content, reviewing and editing existing content, or fixing bugs. This document covers the following topics: -- [How to Contribute](#contribute) -- [Document Source Files and Tools](#source_tools) -- [Writing Guidelines](#guidelines) +- [Working with Markdown Files](#working-with-markdown-files) +- [Working with Images and Graphics](#working-with-images-and-graphics) +- [Writing Guidelines](#writing-guidelines) -[]() - -## How to Contribute - -We use the fork-and-pull collaboration method on GitHub: - -1. In your GitHub account, fork the `apache/incubator-geode` repository. -2. Create a local clone of your fork. -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. - -[]() - -## 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. - -- [Working with Markdown Files](#markdown) -- [Working with Images and Graphics](#images) - -[]() - -### Working with Markdown Files +## 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). -[]() - -### Working with Images and Graphics +## Working with Images and Graphics -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. +Image files in .gif or .png format are in the `docs/images` directory in the Apache 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. +Most of the Apache 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. The Wikipedia page [Comparison of Vector Graphics Editors](http://en.wikipedia.org/wiki/Comparison_of_vector_graphics_editors) provides a list and comparison of commercial and free vector graphics editors. Note, however, that not all of these programs support the SVG format. -[]() - ## Writing Guidelines -The most important advice we can provide for working with the Project 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: +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. http://git-wip-us.apache.org/repos/asf/incubator-geode/blob/131e99ee/geode-docs/README.md ---------------------------------------------------------------------- diff --git a/geode-docs/README.md b/geode-docs/README.md index 9f83260..9fb5870 100644 --- a/geode-docs/README.md +++ b/geode-docs/README.md @@ -1,4 +1,4 @@ -# Project Geode End-User Documentation +# 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.