adding a bit more to the docs