some comprehensive docs are added