logoalt Hacker News

csoursyesterday at 6:08 PM1 replyview on HN

https://en.wikipedia.org/wiki/Tacit_knowledge

Well, I knew what I meant.

I tried to commit documentation to our source repository; I was told to upload it to the documentation site instead.

The documentation site that we've used for one year, subsequent to the previous documentation site the we used for 3 years, subsequent to the previous documentation site that we used for 5 years.

Following the trend, by the end of this year we will migrate documentation every 5 minutes, degrading every time.

At least source code can be migrated with fidelity. (The main branch anyway)

Who me? Bitter and scarred not at all!


Replies

PaulHouleyesterday at 7:32 PM

I have a strong preference for checking in docs with the source code but I'm a software dev.

We have a data team where I work that has a huge Confluence Wiki that helps them maintained shared reality about procedures and standards. I never log into it, if I need to know something from their point of view I go next door and ask one of them.