2 ms·
If this is for software developers, Notion also belongs to trash. It is slow to use, you need to click for everything etc. The best documentation is straight i
by oxff 4y ago
If this is for software developers, Notion also belongs to trash. It is slow to use, you need to click for everything etc.
The best documentation is straight in the code file: module documentation at top, then method documentation for each method with a simple example / doc test showing what is the input-output relationship, the second best is an .md file in same repo etc. the more friction you add the worse you make this process for software developers (Jira / Confluence as the king dog shit of documentation process - these are not for developers these are for people who need job security).
- stitched2gethr 4y agoI use Notion for general docs and it's... fine. It has basically everything I want from a general document manager without getting in the way. Agreed though, code docs should be in the code. With the code or in well placed READMEs.