After dozens of nits from @practicalswift I decided to bite the bullet and figure out how to get a c++ linter running in my IDE. I haven't figured it out yet, but I took some notes... Can add to developer docs later:

Command line:

...  the_file_you_worked_on.[h/cpp]

Atom

Install linter-gcc and its dependencies.

Create a new file .gcc-flags.json with the following:

{
  "gccIncludePaths": "src"
}

TODO:

• figure how to add dependencies to include path and/or how not to duplicate that effort (call make?)
• add .gcc-flags.json to project or to .gitignore in the PR along with these instructions

macOS specific

Install gcc via Homebrew: brew install gcc, and point to that binary in the GCC Executable Path setting: /usr/local/Cellar/gcc/8.2.0/bin/g++-8

[other editor]