News for hackers. Stuff that matters.
Re:Mistakes I've Made as an Engineering Manager by Kranar on Sunday February 21, 2021 @07:18PM (#26218813)
I assume you're referring specifically to the coding style document rather than the host of things that a company should document. The advantage of having the coding style documented in a format that supports some kind of markup over a plain text file is to support syntax highlighting, searching/indexing, cross referencing other documents, including diagrams and a host of other features that plain text files lack support for.
Re:Mistakes I've Made as an Engineering Manager by tharkun__ on Sunday February 21, 2021 @08:16PM (#26219424)
You should not assume and I should have specified more clearly.

Our code style is also committed. As spotless configuration files, eslint configuration files etc. You can run these locally if you want to. Our CI/CD definitely runs them and fails the build if it doesn't pass. No exceptions.

The README.md I am speaking of is actually more than one README.md. We have more generalized ones dealing with "This is how to set up your dev env, so you can actually develop stuff", to more module specific ones like "this module is special from everything else in X, Y and Z".