On “MISTAKES.md”
Ideas often get copied from well-known established projects into new projects with the background behind those decisions lost. Projects should have a "https://t.co/iLkkhljAHY" to lay out regretful design choices that can't be reversed for time, compatibility, etc. reasons— Joe Groff (@jckarter) January 14, 2019