generally it helps to make the readme more of a map of content where you have the big picture for each section and then let people dive via links where they want to know more.