bashhacker

Joined 4 years ago

Karma

Submissions

Member since

Feb 20

Recent submissions

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

This shares the burden of the interrupt work. It's still interrupt work, and it still slows down someone's velocity, but because it punishes the service designers for their poor design decisions, those get better over time and the overall quantity of bugs goes down, not up.

Comment · 4 years ago

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.