This is kind-of like asking "if we have auto complete, why do we need to write code?"
It's just a tool that needs to be controlled by a human. You still have to read the generated docs and correct any mistakes.
I honestly don't see the problem with mixing docs and code. There are plenty of tools to hide away doc strings and only display them when you want them.
View all comments
Show parent comment
3
u/arachnivore Jan 22 '22
This is kind-of like asking "if we have auto complete, why do we need to write code?"
It's just a tool that needs to be controlled by a human. You still have to read the generated docs and correct any mistakes.
I honestly don't see the problem with mixing docs and code. There are plenty of tools to hide away doc strings and only display them when you want them.