reworked docs, updated to pass check
added rbuildignore
a few small changes in the docs