DEV Community

Discussion on: What are some examples of open-source projects with great READMEs?

Collapse
 
roywj profile image
Roy

I made one recently. It's for my icon open-source project called Neu Icons. At the beginning of writing the README, I found many issues about how I can make it visually as I want. But time goes by I learned how the markdown works and so on. And now I am pretty happy with it.

The importance of writing README for me have these aspects:

  • Describe what the project is for
  • Clear information about how to use it
  • Write as detail as possible, it will help people to understand the project, a lot
  • Give some notes if some features are under construction
  • Give some credits to people who helped to bring the project live to the community
Collapse
 
radiomorillo profile image
Stephanie Morillo

Good tips, thanks Roy!