On that subject, would there be interest in me adding more detailed `README`s explaining the architecture of underlying components (i.e. a better

src/python/pants/option/README.md

for example)?