less insane indentation
start crazy documentation push

use CODO so very similar to YARD from ruby module

cutting and pasting a lot from ruby version while tired, so may have
made a few mistakes here and there, still enough that its an overall
win!  will catch any doc gotchas later
minor cleanup