feat(analytics): add voluntary tracking code

* build(analytics): add tracking code

GH-20

* docs(csv): add sample CSV

* docs(csv): add sample CSV


From `gregswindle/eslint-plugin-crc` Issues.

* feat(analytics): add yeomon/insight

Prompts consumers to allow for tracking on Google Analytics

GH-20

* ci(travis): run standard-version

Run standard-version on release and commit its
artifacts.

GH-20

* ci(travis): clarify release step

GH-20

* docs(contribute): update toc & scripts

GH-20

Author: gregswindle

.github/CONTRIBUTING.md

@@ -62,6 +62,9 @@
 - [5. **Directory structure**](#5-directory-structure)
 - [6. **Logging**](#6-logging)
 - [7. **Dependencies**](#7-dependencies)
+  * [7.1. Production](#71-production)
+  * [7.2. Development](#72-development)
+  * [7.3. Optional](#73-optional)
 - [8. **APIs**](#8-apis)
   * [8.1 **API design**](#81-api-design)
   * [8.2 **API security**](#82-api-security)
@@ -710,12 +713,31 @@
 
 ## 7. **Dependencies**
 
-`github-resource-converter` requires the following tech stack to either run, build, test, or deploy:
+### 7.1. Production
+
+`github-resource-converter` requires the following dependencies to operate.
+
+<!-- AUTO-GENERATED-CONTENT:START (DEPENDENCYTABLE:production=true) -->
+| **Dependency** | **Description** | **Version** | **License** | **Type** |
+| -------------- | --------------- | ----------- | ----------- | -------- |
+ | [@octokit/rest@15.2.6](https://github.com/octokit/rest.js#readme) | GitHub REST API client for Node.js | 15.2.6 | MIT | production | 
+ | [bunyan@1.8.12](https://github.com/trentm/node-bunyan#readme) | a JSON logging library for node.js services | 1.8.12 | MIT | production | 
+ | [bunyan-format@0.2.1](https://github.com/thlorenz/bunyan-format) | Writable stream that formats bunyan records that are piped into it. | 0.2.1 | [object Object] | production | 
+ | [dotenv@5.0.1](https://github.com/motdotla/dotenv#readme) | Loads environment variables from .env file | 5.0.1 | BSD-2-Clause | production | 
+ | [fs-extra@5.0.0](https://github.com/jprichardson/node-fs-extra) | fs-extra contains methods that aren't included in the vanilla Node.js fs package. Such as mkdir -p, cp -r, and rm -rf. | 5.0.0 | MIT | production | 
+ | [insight@0.10.1](https://github.com/yeoman/insight#readme) | Understand how your tool is being used by anonymously reporting usage metrics to Google Analytics or Yandex.Metrica | 0.10.1 | BSD-2-Clause | production | 
+ | [jsonexport@2.0.11](https://github.com/kauegimenes/jsonexport) | Makes easy to convert JSON to CSV | 2.0.11 | ISC | production | 
+ | [lodash.isstring@4.0.1](https://lodash.com/) | The lodash method `_.isString` exported as a module. | 4.0.1 | MIT | production | 
+ | [meow@4.0.0](https://github.com/sindresorhus/meow#readme) | CLI app helper | 4.0.0 | MIT | production | 
+<!-- AUTO-GENERATED-CONTENT:END -->
+
+### 7.2. Development
+
+`github-resource-converter` uses the the following dependencies to build, test, or deploy:
 
 <!-- AUTO-GENERATED-CONTENT:START (DEPENDENCYTABLE:dev=true) -->
 | **Dependency** | **Description** | **Version** | **License** | **Type** |
 | -------------- | --------------- | ----------- | ----------- | -------- |
- | [@semantic-release/changelog@2.0.1](https://github.com/semantic-release/changelog#readme) | Set of semantic-release plugins for creating or updating a changelog file | 2.0.1 | MIT | dev | 
  | [@semantic-release/git@4.0.1](https://github.com/semantic-release/git#readme) | Set of semantic-release plugins to publish to a git repository | 4.0.1 | MIT | dev | 
  | [@semantic-release/npm@3.2.4](https://github.com/semantic-release/npm#readme) | Set of semantic-release plugins to publish to a npm registry | 3.2.4 | MIT | dev | 
  | [ajv@6.4.0](https://github.com/epoberezkin/ajv) | Another JSON Schema Validator | 6.4.0 | MIT | dev | 
@@ -729,22 +751,24 @@
  | [eslint-config-standard@11.0.0](https://github.com/standard/eslint-config-standard) | JavaScript Standard Style - ESLint Shareable Config | 11.0.0 | MIT | dev | 
  | [eslint-config-xo@0.20.1](https://github.com/xojs/eslint-config-xo#readme) | ESLint shareable config for XO | 0.20.1 | MIT | dev | 
  | [eslint-plugin-import@2.10.0](https://github.com/benmosher/eslint-plugin-import) | Import with sanity. | 2.10.0 | MIT | dev | 
- | [eslint-plugin-jsdoc@3.5.0](https://github.com/gajus/eslint-plugin-jsdoc#readme) | JSDoc linting rules for ESLint. | 3.5.0 | BSD-3-Clause | dev | 
+ | [eslint-plugin-jsdoc@3.6.2](https://github.com/gajus/eslint-plugin-jsdoc#readme) | JSDoc linting rules for ESLint. | 3.6.2 | BSD-3-Clause | dev | 
  | [eslint-plugin-json@1.2.0](https://github.com/azeemba/eslint-plugin-json#readme) | Lint JSON files | 1.2.0 | ISC | dev | 
  | [eslint-plugin-no-unsafe-innerhtml@1.0.16](https://github.com/mozfreddyb/eslint-plugin-no-unsafe-innerhtml/) | custom ESLint rule to disallows unsafe innerHTML, outerHTML and insertAdjacentHTML | 1.0.16 | MPL-2.0 | dev | 
  | [eslint-plugin-node@6.0.1](https://github.com/mysticatea/eslint-plugin-node#readme) | Additional ESLint's rules for Node.js | 6.0.1 | MIT | dev | 
  | [eslint-plugin-prettier@^2.2.0](https://github.com/prettier/eslint-plugin-prettier#readme) | Runs prettier as an eslint rule | 2.6.0 | MIT | dev | 
  | [eslint-plugin-promise@3.7.0](https://github.com/xjamundx/eslint-plugin-promise#readme) | Enforce best practices for JavaScript promises | 3.7.0 | ISC | dev | 
  | [eslint-plugin-security@1.4.0](https://github.com/nodesecurity/eslint-plugin-security#readme) | Security rules for eslint | 1.4.0 | Apache-2.0 | dev | 
  | [eslint-plugin-standard@3.0.1](https://github.com/xjamundx/eslint-plugin-standard#readme) | ESlint Plugin for the Standard Linter | 3.0.1 | MIT | dev | 
- | [eslint-plugin-unicorn@4.0.2](https://github.com/sindresorhus/eslint-plugin-unicorn#readme) | Various awesome ESLint rules | 4.0.2 | MIT | dev | 
+ | [eslint-plugin-unicorn@4.0.3](https://github.com/sindresorhus/eslint-plugin-unicorn#readme) | Various awesome ESLint rules | 4.0.3 | MIT | dev | 
  | [eslint-plugin-xss@0.1.9](https://github.com/Rantanen/eslint-plugin-xss#readme) | Validates XSS related issues of mixing HTML and non-HTML content in variables. | 0.1.9 | ISC | dev | 
  | [fixpack@2.3.1](https://github.com/henrikjoreteg/fixpack) | cli tool that cleans up package.json files. | 2.3.1 | MIT | dev | 
  | [husky@^0.14.3](https://github.com/typicode/husky) | Prevents bad commit or push (git hooks, pre-commit/precommit, pre-push/prepush, post-merge/postmerge and all that stuff...) | 0.14.3 | MIT | dev | 
  | [jest@22.4.3](http://facebook.github.io/jest/) | Delightful JavaScript Testing. | 22.4.3 | MIT | dev | 
  | [jest-runner-eslint@0.4.0](https://github.com/jest-community/jest-runner-eslint) | An experimental ESLint runner for Jest | 0.4.0 | MIT | dev | 
  | [lec@^1.0.1](https://github.com/iShafayet/lec) | Command Line Wrapper for Line Ending Corrector (An utility that makes sure your files have consistent line endings) | 1.0.1 | MIT | dev | 
- | [lint-staged@7.0.3](https://github.com/okonet/lint-staged#readme) | Lint files staged by git | 7.0.3 | MIT | dev | 
+ | [lint-staged@7.0.4](https://github.com/okonet/lint-staged#readme) | Lint files staged by git | 7.0.4 | MIT | dev | 
+ | [lodash.isundefined@3.0.1](https://lodash.com/) | The modern build of lodash’s `_.isUndefined` as a module. | 3.0.1 | MIT | dev | 
+ | [lodash.noop@3.0.1](https://lodash.com/) | The lodash method `_.noop` exported as a module. | 3.0.1 | MIT | dev | 
  | [markdown-magic@0.1.21](https://github.com/DavidWells/markdown-magic#readme) | Automatically update markdown files with content from external sources | 0.1.21 | MIT | dev | 
  | [markdown-magic-dependency-table@1.3.2](https://github.com/camacho/markdown-magic-dependency-table#readme) | Generate table of information about dependencies automatically in markdown | 1.3.2 | MIT | dev | 
  | [markdown-magic-install-command@1.3.1](https://github.com/camacho/markdown-magic-install-command#readme) | Print install command for markdown file | 1.3.1 | MIT | dev | 
@@ -755,6 +779,13 @@
  | [standard-version@4.3.0](https://github.com/conventional-changelog/standard-version#readme) | replacement for `npm version` with automatic CHANGELOG generation | 4.3.0 | ISC | dev | 
 <!-- AUTO-GENERATED-CONTENT:END -->
 
+### 7.3. Optional
+
+<!-- AUTO-GENERATED-CONTENT:START (DEPENDENCYTABLE:optional=true) -->
+| **Dependency** | **Description** | **Version** | **License** | **Type** |
+| -------------- | --------------- | ----------- | ----------- | -------- |
+<!-- AUTO-GENERATED-CONTENT:END -->
+
 ## 8. **APIs**
 
 ![APIs][icon-rest-api-image]

.github/config/markdown.config.js

@@ -1,20 +1,25 @@
 /* eslint global-require: "off" */
 /* eslint node/no-unpublished-require: "off" */
-const path = require('path')
 const markdownMagic = require('markdown-magic')
 const markdownMagicDependencyTable = require('markdown-magic-dependency-table')
 const markdownMagicPackageScripts = require('markdown-magic-package-scripts')
+const path = require('path')
 
 const config = {
-  'DEBUG': false,
-  'transforms': {
-    'DEPENDENCYTABLE': markdownMagicDependencyTable,
-    'SCRIPTS': markdownMagicPackageScripts
+  DEBUG: false,
+  transforms: {
+    DEPENDENCYTABLE: markdownMagicDependencyTable,
+    SCRIPTS: markdownMagicPackageScripts
   }
 }
 
-let markdownPath = path.join(__dirname, '**/*.md')
-markdownMagic(markdownPath, config)
+const main = () => {
+  let markdownPath = path.join(__dirname, '**/*.md')
+  markdownMagic(markdownPath, config)
+
+  markdownPath = path.join(__dirname, '..', 'CONTRIBUTING.md')
+  console.log(markdownPath)
+  markdownMagic(markdownPath, config)
+}
 
-markdownPath = path.join(__dirname, '../*.md')
-markdownMagic(markdownPath, config)
+main()

.github/config/sonar-project.properties

@@ -29,7 +29,7 @@ sonar.sourceEncoding=UTF-8
 #----- Project info
 sonar.projectKey=gregswindle-github-resource-converter
 sonar.projectName=github-resource-converter
-sonar.projectVersion=1.0.0
+sonar.projectVersion=1.0.1
 
 # =====================================================
 #   Meta-data for the project

.travis.yml

@@ -45,4 +45,6 @@ deploy:
   provider: script
   skip_cleanup: true
   script:
+    - npm run docs:changelog
+    - git commit -a --amend --no-edit
     - npx travis-deploy-once "npx semantic-release"

README.md

@@ -89,7 +89,14 @@
 
 ## 2. Installation
 
-1.  **Required:** `github-resource-converter` is written in JavaScript (CommonJS) for [Node.js ![External link][icon-octicon-link-external]](https://nodejs.org/), which must be installed prior to use. Node.js requires **npm**, which is used for installing dependencies. (**npm** installs with Node.js.)
+1.  **Required:** `github-resource-converter` is written in JavaScript (CommonJS) for
+    [Node.js ![External link][icon-octicon-link-external]](https://nodejs.org/) version
+    <!-- AUTO-GENERATED-CONTENT:START (ENGINES) -->
+
+  <!-- AUTO-GENERATED-CONTENT:END -->
+
+which must be installed prior to use.
+Node.js requires **npm**, which is used for installing dependencies. (**npm** installs with Node.js.)
 
 1.  **Recommended:** To avoid rate-limiting, you should [create a personal access token ![External link][icon-octicon-link-external]](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/) and save your personal access token.