HOTFIX: Achieve 100% doc coverage

fixing some YARD formatting issues + pull from master

```
yard stats --list-undoc 
```
```
Files:          32
Modules:        19 (    0 undocumented)
Classes:        26 (    0 undocumented)
Constants:       3 (    0 undocumented)
Methods:       145 (    0 undocumented)
 100.00% documented
```