Ask HN: How to Document Everything? I work in a small team of data scientists and next quarter I will need to document every minimal aspect of the work we do. I'm talking about processes, databases, scripts, functions and API endpoints. This documentation will be consumed both by those involved in development and by other stakeholders who are not tech-savvy. What would HN use in this case? |
Even if you have to describe everything, what’s wrong with a high-level description that gives links to your code repository for “every minimal aspect”? That at least has some chance of still being correct six months from now.
And that’s ignoring the remark “This documentation will be consumed by […] stakeholders who are not tech-savvy.”
Describing every minimal aspect of processes, databases, scripts, functions and API endpoints to them is madness.
Secondly, hire a technical writer.