It seems possible to generated "readthedocs" type of documentation from the yardl files. This would probably need stricter guidelines on how to write the documentation, and it might not be so easy to have it organised logically (maybe via some tags).