Add explanation of status_flag, quality_flag, other QC flag standard names to Chapter 3.4

.github/workflows/check_adoc_build.yml

@@ -0,0 +1,68 @@
+#
+# GitHub Actions Workflow for pull request events against the master branch to
+# make sure Asciidoctor still builds. If successful, the resulting html and
+# pdf files are uploaded as artifacts to make it easier to preview the results
+# of a PR.
+#
+# For more information on the actions used in this workflow, please see:
+#   https://github.com/actions/checkout 
+#   https://github.com/Analog-inc/asciidoctor-action
+#   https://github.com/actions/upload-artifact
+#
+name: Check Asciidoctor Build
+on:
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  # Job to build cf-conventions.html, cf-conventions.pdf
+  build_conventions:
+    name: Build cf-conventions html and pdf
+    runs-on: ubuntu-latest
+    steps:
+    # Check out PR
+    - uses: actions/checkout@v2
+    # Create build directory
+    - run: mkdir conventions_build
+    # Build cf-conventions.html using the Analog-inc asciidoctor-action
+    - name: Build cf-conventions.html
+      uses: Analog-inc/[email protected]
+      with:
+        shellcommand: 'asciidoctor --verbose cf-conventions.adoc -D conventions_build'
+    # Build cf-conventions.pdf using the Analog-inc asciidoctor-action
+    - name: Build cf-conventions.pdf
+      uses: Analog-inc/[email protected]
+      with:
+        shellcommand: 'asciidoctor-pdf --verbose -d book cf-conventions.adoc -D conventions_build'
+    # Upload artifact containing cf-conventions.html, cf-conventions.pdf
+    - name: Upload cf-conventions doc preview
+      uses: actions/upload-artifact@v1
+      with:
+        name: conventions docs
+        path: conventions_build/
+
+  # Job to build conformance.html, conformance.pdf
+  build_conformance:
+    name: Build conformance html and pdf
+    runs-on: ubuntu-latest
+    steps:
+    # Checkout PR
+    - uses: actions/checkout@v2
+    # Create build directory
+    - run: mkdir conformance_build
+    # Build conformance.html using the Analog-inc asciidoctor-action
+    - name: Build conformance.html
+      uses: Analog-inc/[email protected]
+      with:
+        shellcommand: 'asciidoctor --verbose conformance.adoc -D conformance_build'
+    # Build conformance.pdf using the Analog-inc asciidoctor-action
+    - name: Build conformance.pdf
+      uses: Analog-inc/[email protected]
+      with:
+        shellcommand: 'asciidoctor-pdf --verbose -d book conformance.adoc -D conformance_build'
+    # Upload artifact containing conformance.html, conformance.pdf
+    - name: Upload conformance doc preview
+      uses: actions/upload-artifact@v1
+      with:
+        name: conformance docs
+        path: conformance_build/

README.md

@@ -19,3 +19,13 @@ To convert the AsciiDoc files into the resulting HTML file:
 4. Build the HTML: `asciidoctor cf-conventions.adoc`
 
 See the [GitHub help](https://help.github.com/) pages and plethora of other git/GitHub guides for more details on how to work with repos, forks, pull requests, etc.
+
+### Latest Spec Build
+
+Whenever a [pull request](https://github.com/cf-convention/cf-conventions/pulls) is merged, a [travis-ci build](https://travis-ci.org/github/cf-convention/cf-conventions) generates the latest specification draft and adds it to the [gh-pages branch here](https://github.com/cf-convention/cf-conventions/tree/gh-pages). The gh-pages branch is deployed to github pages at the following documents:
+- http://cfconventions.org/cf-conventions/cf-conventions.html
+- http://cfconventions.org/cf-conventions/cf-conventions.pdf
+- http://cfconventions.org/cf-conventions/conformance.html
+- http://cfconventions.org/cf-conventions/conformance.pdf 
+
+These documents are linked in the cf-conventions web site. [source here](https://github.com/cf-convention/cf-convention.github.io) which is published to: http://cfconventions.org/. The latest spec documents are linked from those web pages here: http://cfconventions.org/latest.html.