Since FYIs lack context, theres still a need for why-docs (eg a wiki page) about connecting to dev/prod dbs, which mentions the dbconnect command along with other relevant resources. But if the how-docs are largely left in FYIs, those why-docs are less likely to go stale.

So FYIs allow us to decouple how-docs from why-docs. The tactical details are probably what you want in a hurry. The narrative around them is something you sit back and read on a wiki page.

FYIs allow us to decouple how-docs from why-docs

Source: Etsys experiment with immutable documentation - Code as Craft

Interesting idea.