News for hackers. Stuff that matters.
Re:How I, a beginner developer, read the tutorial you, a dev... by mschild on Monday September 22, 2025 @06:01AM (#45331221)
I think that always depends entirely on the docs and how people are instructed to use them.

From a software engineer standpoint, we have a larger collection of docs for the internal platform we run. The docs for other engineers follow the diátaxis framework [0] for documentation. Its the best approach we've found so far and the overall questions and guidance my team needed to provide reduced by a significant margin while the PRs we know receive have increased in quality and quantity.

[0] https://diataxis.fr/

There are no comments on this comment yet.