adding more details in documentation again