oz icon indicating copy to clipboard operation
oz copied to clipboard

RDoc for CORE

Open PanoramicPanda opened this issue 7 years ago • 1 comments

Create RDoc documentation for CORE Methods such as world, elements, pages, ledger, and logger.

PanoramicPanda avatar Sep 06 '18 16:09 PanoramicPanda

While documentation for CORE would be nice, i don't necessarily think we should use RDocs for it. I'd personally prefer to have a good suite of unit tests and then from that generate docs using a tool like relish.

The problem with manually written documenters like RDoc is that they frequently fall out of spec with the things that they describe. (there's NOTHING worse than a magic comment that says it does something completely different than what the code under it actually does.) At least if you generate your docs from unit and integration tests then you get a notification when this happens.

Castone22 avatar Jul 12 '19 18:07 Castone22