thevinter

Hello. I'm currently working in consultancy, with multiple teams distributed across various domains and timezones.

Often I find that there are specific processes that need to be documented (or for which I need to find documentation for). I.e. script locations, set up instructions, caveats for specific executions etc.

It happens often that I write something just to find out later that the same information was already present somewhere else, written by someone two weeks ago, buried in confluence subfolders.

I'm looking for any advice to optimize cross-team information distribution, searchability and availability. Specifically for information that doesn't easily lend itself to structured locations like readmes and code documentation.

Are there best practices or tools that you could recommend?

Hi, I like to store documentation, notes and research documents for many of my personal projects. At the moment I'm using Obsidian/Notion, but (at least to my knowledge) they lack the ability to easily embed and reference parts of the codebase.

So I'm looking for a tool/plugin that allows me to treat both documentation and code as first-class citizens in the app.

Ideal requirements: - Be able to edit documentation/code in the same app without losing too much editing functionality (while a LSP is good, I'd be satisfied with basic syntax highlighting) - Be able to reference files, folders and parts of code as links in my documentation - Have everything be saved as physical files on disk (something Notion doesnt really support)

Does anyone know of something similar? Thanks