One of the points in our 2020 Retrospective and 2021 Outlook was to use stronger open source best practices for our internal projects, including better documentation, and I think what you’re saying here is very aligned with that and makes a lot of sense. Even just for internal onboarding of new team members it makes sense, but if we want to see our projects get more traction as open source projects with an active community, it is very important. So +1 from me.
FWIW I wrote up some of this on a recent forum post. Not very discoverable for people exploring the project, I know.