[WIP] [DO_NOT_MERGE] create a troubleshooting guide

This is an h1 - you should only have one of those per file.  Switch to '--------' which is h2