Right now the readme is an accumilation of changes over time and has never really had any love to structure it better. I think using something like https://readme.so/ would be a good start.