noticed minor dox inconsistency, modified with a relevant example...
noticed other very minor dox issue