It may be better to re-structure the main readme by breaking out sections like "I have a new algorithm" and "i have a new test" into separate readme's and linking them out of the main read. This might add clarity and make the main readme faster to digest and understand