Hacker News new | ask | show | jobs
by limandoc 1037 days ago
> documentation should be near the source I totally agree with this statement. Moreover, I plan to have a feature that will allow to place your whole project folder into your vault in my app and then reference a diagram through the code/inner file (e.g. using comment blocks). And that file will be visible, searchable, within my documentation software. Think of it as a layer above the code.

However I do not want to tie the documentation process to git as it will be harder for other team members (think of POs, Teamleads, clients) to find the documentation through git history. Instead, a separate IDE for documentation (as is my app) is an ideal place to store & share knowledge. Just like there is separate app for slack, e-mail, browser, etc.

Thanks for your thoughts!