This article is really detailed, and I haven't had a chance to review it in full yet.

https://pronovix.com/blog/developer-portals-best-practices-documentation-patterns

A thorough review of it may provide recommendations that can be applied to the documentation template. Thanks to @mvogelgesang for sharing it.