Adding additional documentation and admonitions

[skip ci]
Appeasing the rubocop