[Bro-Dev] [JIRA] (BIT-1520) topic/dnthayer/doc-improvements