more comprehensive and prettier docs