3 ms·
Documentation is also where things run, which resources they access and how and why they do it. I’m not a big fan of executable testing or self-documenting cod
by moksly 5y ago
Documentation is also where things run, which resources they access and how and why they do it.
I’m not a big fan of executable testing or self-documenting code in smaller projects. Sure you solve a lot with good naming, but it’s usually the business logic that needs to be documented.
I can easily ready how a piece of Python or C# works, but I can’t easily tell why employees who only work less than 7 hours a week and are paid in advance are excluded from the function I’m looking at.
But I mean more generally. We selfhost some things, have others in azure, and have a lot of different databases and projects. It’s nice to have a reference sheet of which belong to each other.