Comment by mst
8 months ago
Perhaps consider moving the warning in the NOTE at the bottom of the README.md to a DISCLAIMER section near the top.
I read the whole thing first, then commented, but people often read half of such a document, assume they've got all the important bits, and dive straight in.
(we used to have that problem at $work with new team members and our onboarding doc; I added a section at the bottom that was pure silliness, and then started asking people who claimed to have read it a question that would only make sense if they'd seen the joke ... generally followed by telling them to go back and finish reading and not to try that with me again ;)
No comments yet
Contribute on Hacker News ↗