Skip to content

Commit

Permalink
GEODE-2498 Revise published 1.1.0 manual, so it has
Browse files Browse the repository at this point in the history
no references to 1.0.0-incubating
  • Loading branch information
Karen Miller committed Feb 16, 2017
1 parent 0513276 commit 7f0f4d5
Show file tree
Hide file tree
Showing 654 changed files with 1,783,820 additions and 2 deletions.
2 changes: 1 addition & 1 deletion geode-docs/about_geode.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,6 @@ See the License for the specific language governing permissions and
limitations under the License.
-->

This documentation describes product concepts and provides complete setup instructions for Apache Geode 1.0.0-incubating. Source files are available at [https://github.com/apache/geode/tree/develop/geode-docs](https://github.com/apache/geode/tree/develop/geode-docs) and instructions on how to build this documentation is available at [https://github.com/apache/geode/blob/develop/geode-book/README.md](https://github.com/apache/geode/blob/develop/geode-book/README.md).
This documentation describes product concepts and provides complete setup instructions for Apache Geode. Source files are available at [https://github.com/apache/geode/tree/develop/geode-docs](https://github.com/apache/geode/tree/develop/geode-docs) and instructions on how to build this documentation is available at [https://github.com/apache/geode/blob/develop/geode-book/README.md](https://github.com/apache/geode/blob/develop/geode-book/README.md).

You can also find additional documentation about Geode on the **Apache Geode Wiki**: [https://cwiki.apache.org/confluence/display/GEODE/Index](https://cwiki.apache.org/confluence/display/GEODE/Index).
2 changes: 1 addition & 1 deletion geode-docs/prereq_and_install.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ See the License for the specific language governing permissions and
limitations under the License.
-->

Each host of Apache Geode 1.0.0-incubating that meets a small set of prerequisites may follow the provided installation instructions.
Each host of Apache Geode that meets a small set of prerequisites may follow the provided installation instructions.

- **[Host Machine Requirements](getting_started/system_requirements/host_machine.html)**

Expand Down
54 changes: 54 additions & 0 deletions geode-site/website/content/docs/guide/11/CONTRIBUTE
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

<h1>Contributing to the Apache Geode Documentation</h1>

<p>Apache Geode welcomes your contributions to the community&rsquo;s documentation efforts. You can participate by writing new content, reviewing and editing existing content, or fixing bugs. This document covers the following topics:</p>

<ul>
<li><a href="#working-with-markdown-files">Working with Markdown Files</a></li>
<li><a href="#working-with-images-and-graphics">Working with Images and Graphics</a></li>
<li><a href="#writing-guidelines">Writing Guidelines</a></li>
</ul>

<p>For instructions on building the documentation locally, see <code>../geode-book/README.md</code>.</p>

<h2>Working with Markdown Files</h2>

<p>You can edit markdown files in any text editor. For more, read <a href="https://daringfireball.net/projects/markdown/syntax">Daring Fireball&rsquo;s Markdown Syntax page</a>.</p>

<h2>Working with Images and Graphics</h2>

<p>Image files in .gif or .png format are in the <code>docs/images</code> directory in the Apache Geode docs repo. Images in .svg format are in the <code>docs/images_svg</code> directory.</p>

<p>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.</p>

<p>The Wikipedia page <a href="http://en.wikipedia.org/wiki/Comparison_of_vector_graphics_editors">Comparison of Vector Graphics Editors</a> provides a list and comparison of commercial and free vector graphics editors. Note, however, that not all of these programs support the SVG format.</p>

<h2>Writing Guidelines</h2>

<p>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:</p>

<ul>
<li>Top-level subdirectories organize topics into &ldquo;books&rdquo;: basic_config, configuring, developing, etc.</li>
<li>Use lowercase characters for all file and directory names. Separate words in filenames with an underscore (<code>_</code>) character.</li>
<li>Use the <code>.md</code> file extension for topic files.</li>
<li>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.</li>
<li>To start a new topic, you can make a copy of an existing file with similar content and edit it.</li>
<li>Use the appropriate document type for the content you are writing. Create multiple topics if you are writing overview, procedural, and reference content.</li>
<li>To edit elements in the navigation pane (the &ldquo;subnav&rdquo;) that appears on the left side of the documentation, navigate to <code>../geode-book/master_middleman/source/subnavs/geode-subnav.md</code>.</li>
</ul>
Loading

0 comments on commit 7f0f4d5

Please sign in to comment.