new way to document rulus + some bug fixes