HACKER Q&A
📣 tonyaldon

When is the last time you wished the docs were in a single file?


For me, it was today. Not the first time I've felt this.

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?


  👤 JohnFen Accepted Answer ✓
This isn't something I get overly fussed about except at the extremes. I don't like thousands of single-paragraph docs, and I also don't like having everything in a single multi-MB doc.