add some more details to documentation