I'm convinced dev docs for most projects should live in a single text file.

Everyone can open it in their preferred IDE and find or replace what they need. Search on docs websites is often broken. But not in my editor, and not in yours either.

Copy-pasting snippets is easy, with no context switching. You can pass the file as context to your preferred AI assistant. No need for extra tools to gather every tiny piece scattered across many files.

It's so simple that I don't understand why this isn't the norm.

What about you?