Updates to Documentation to improve concepts and update small bugs in the segment flow