misc documentation fixes

@fosdev Please review and merge!
@brutski This seems strange actually, now that I am looking at this. Seems this should accept strings or symbols. Maybe this needs a patch in crichton?