A bit of inspiration most weekdays for exploring your mindset .

🧏Consider adding WHY.md

Khem Raj October 27, 2025 #meta

A lot of open-source projects on GitHub and other hosting places have project documentation as part of project. More now than before as Markdown format has enabled all of us to write clean documents.

Along with design documents and user manuals. There are commonly found documents e.g. README.md, CONTRIBUTING.md, INSTALL.md, AUTHORS.md etc. these are very helpful document for someone who is new to project and is onboarding to community.

Some projects do have additional documents touching on rationale and history of the project but its not as common.

Consider adding a WHY.md for the project, this document describes reasons for the project to start and exist today, why certain important decisions were made along the way ( e.g. choice of programming language ). An intrinsic reason, the philosophy behind the project written by authors for starting the project.

Developers are not only looking for learning new things but also for reason and purpose. A well written 'WHY' appeals to the core of the human system. A well written "WHY.md" will take the project further than it would be without it.