Documentation fixes and more clarity for some parts