docs given better structure