Also why having doc comments and docs generated from code are super useful. When someone changes the code but not the comment above, it becomes really obvious that something was missed as opposed to having code and doc changes be two separate tasks.
Comment on Why is it so hard finding up-to-date docs and guides?
jrandiny@lemmy.world 1 year ago
This is why having a dedicated person/team to maintain docs is very important
Gecko@lemmy.world 1 year ago
Dharkstare@kbin.social 1 year ago
I've always felt that programmers need one day out of the week where they explain what their code does to someone dedicated to writing documentation. That way the code is being documented while you still understand what it does and the documentation is constantly being updated.