3 ms·
Ask HN: 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 10mo agoThis 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.
- tonyaldon 10mo agoI agree. Multi-MB docs are not my thing either, but it seems to happen only rarely. Projects with multi-MB docs often have the capacity and willingness to offer good search on their site. What annoys me more are small to medium projects with scattered docs and no, or poor, search.