bashhacker

My advice: have a maturity standard for services. Ensure they meet a certain standard before they are handed off to the SRE team. Until the service meets maturity standards to qualify for full SRE support, the team that engineered the service is frontline support. If the service maturity regresses, primary support reverts.

Here is our yardstick: https://gitlab.com/dreamer-labs/tsc/service-maturity-model

Take a look at shfmt and shdoc. One is an auto formatter, the other does autodocs. I wouldn't invent yet another docstring format. It's already been done. Just check compliance with an existing format.