more documentation for studies functions