add a bit more info to docs