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…
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.
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…
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.