NanaAmun

Totally agree, search is the real bottleneck. Linking from multiple places is such a simple but powerful habit, but again, I guess it comes down to people being lazy.

Imo this just leads to out of date docs within the code it self. We have a no comment policy at the place I work for this reason.

Yeah, that makes sense, but that "if you remember who wrote it or a snippet" part is exactly the problem for me. If you’re not already in the loop, or new to the project, that context just isn’t there. Good search should work even when your memory doesn’t.

Exactly, If I can’t find 90% of the docs, chances are most other people can’t either, therefore no ones maintaining them.

Sounds like we work at the same place.

Do you guys just dump all the dev/depl logs and docs into Confluence? Or is it more curated?

Yes! We just use MS Teams and keep a megathread of links honestly, it’s the best way we’ve found to manage it.

Yeah, we’re trying that too, not going great haha. Recording everything sounds good tho, no clue how that would play with PCI DSS.

I get that, but scale’s the issue, there are over 10k engineers at my current company. I just don’t see how it scales when people are dumping tens of thousands of lines of logs into it daily. You can download everything and embed it using the Google API, then store it in Postgres with pgvector. At this scale, I’m not sure if it would hold up.