From 9cb74f4b788c3ea53fe18bc99ad31f32f821a24c Mon Sep 17 00:00:00 2001
From: Scott Anderson <scott@influxdata.com>
Date: Mon, 7 Oct 2019 11:22:54 -0600
Subject: [PATCH] updated contribution guidelines

---
 .github/PULL_REQUEST_TEMPLATE.md | 15 ++++++++++
 CONTRIBUTING.md                  | 48 ++++++++++++++++++++++++++++----
 2 files changed, 57 insertions(+), 6 deletions(-)
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 000000000..e002f3cc0
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,15 @@
+- [ ] Signed the CLA
+
+#### Issue description
+
+#### Relevant URLs
+
+#### What products and version are you using?
+
+
+<!--
+Is this an issue with the InfluxDB documentation (typos, missing/inaccurate information, etc.)
+or it related to a specific InfluxData project (bug report, unexpected behavior, etc.)?
+Submit product-related issues to the appropriate Github repository in the
+[InfluxData organization](https://github.com/influxdata).
+-->
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3a38d1741..e80f6028b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -3,10 +3,13 @@
 ## Sign the InfluxData CLA
 The InfluxData Contributor License Agreement (CLA) is part of the legal framework
 for the open-source ecosystem that protects both you and InfluxData.
-In order to contribute to any InfluxData project, you must first sign the CLA.
+To make substantial contributions to InfluxData documentation, first sign the InfluxData CLA.
+What constitutes a "substantial" change is at the discretion of InfluxData documentation maintainers.
 
 [Sign the InfluxData (CLA)](https://www.influxdata.com/legal/cla/)
 
+_**Note:** Typo and broken link fixes are greatly appreciated and do not require signing the CLA._
+
 ## Make suggested updates
 
 ### Fork and clone InfluxData Documentation Repository
@@ -202,6 +205,17 @@ Insert Cloud-specific markdown content here.
 {{% /cloud %}}
 ```
 
+#### InfluxDB Cloud content block
+The `{{ cloud-msg }}` shortcode creates a highlighted block of text specific to
+InfluxDB Cloud meant to stand out from the rest of the article content.
+It's format is similar to note and warning blocks.
+
+```md
+{{% cloud-msg %}}
+Insert Cloud-specific markdown content here.
+{{% /cloud-msg %}}
+```
+
 #### InfluxDB Cloud name
 The name used to refer to InfluxData's cloud offering is subject to change.
 To facilitate easy updates in the future, use the `cloud-name` short-code when
@@ -406,15 +420,20 @@ Below is a list of available icons (some are aliases):
 - dashboard
 - dashboards
 - data-explorer
+- delete
 - download
 - duplicate
 - edit
 - expand
 - export
+- eye
+- eye-closed
+- eye-open
 - feedback
 - fullscreen
 - gear
 - graph
+- hide
 - influx
 - influx-icon
 - nav-admin
@@ -439,7 +458,11 @@ Below is a list of available icons (some are aliases):
 - search
 - settings
 - tasks
+- toggle
+- trash
+- trashcan
 - triangle
+- view
 - wrench
 - x
 
@@ -453,12 +476,15 @@ Provide a visual example of the the navigation item using the `nav-icon` shortco
 
 The following case insensitive values are supported:
 
-- admin
-- data explorer, data-explorer
+- admin, influx
+- data-explorer, data explorer
 - dashboards
 - tasks
-- organizations, orgs
-- configuration, config
+- monitor, alerts, bell
+- cloud, usage
+- disks, load data, load-data
+- settings
+- feedback
 
 ### InfluxDB UI notification messages
 In some cases, documentation references a notification message that appears in
@@ -508,6 +534,13 @@ menu:
 ### Image naming conventions
 Save images using the following naming format: `version-context-description.png`. For example, `2-0-visualizations-line-graph.png` or `2-0-tasks-add-new.png`. Specify a version other than 2.0 only if the image is specific to that version.
 
+## InfluxDB API documentation
+InfluxData uses [Redoc](https://github.com/Redocly/redoc) to generate the full
+InfluxDB API documentation when documentation is deployed.
+Redoc generates HTML documentation using the InfluxDB `swagger.yml`.
+For more information about generating InfluxDB API documentation, see the
+[API Documentation README](https://github.com/influxdata/docs-v2/tree/master/api-docs#readme).
+
 ## New Versions of InfluxDB
 Version bumps occur regularly in the documentation.
 Each minor version has its own directory with unique content.
@@ -553,7 +586,10 @@ _This example assumes v2.0 is the most recent version and v2.1 is the new versio
    latest_version: v2.1
    ```
 
-7. Commit the changes and push the new branch to Github.
+7. Copy the InfluxDB `swagger.yml` specific to the new version into the
+   `/api-docs/v<version-number>/` directory.
+
+8. Commit the changes and push the new branch to Github.
 
 
 These changes lay the foundation for the new version.