improving doc part3 including some fixes found during code review while documenting