Google Season of Docs: Suggestion for tweaks in Documentation and Structure

As I said in Google Season of Docs 2020 I do not think this is a strong proposal because it is too generic and I expect a majority of the work to be in developing a sphinx extension to format render the API docs as suggested.