DEV Community

Maxime Guilbert
Maxime Guilbert

Posted on • Updated on

How to write a README?

A README.md file, the beginning of every project.

It's always a challenge to create a good README, when you are working on an open source project, or with a team. We always have a lot of questions in mind about what can we do, add, remove...

Should I add this information?

Is it too much?

Should I add a schema ?

So, to help you to have a good start on what you can do, should do and how to do it, here is Make a README project.

Make a README Project screenshot - Template part


As we talk about for How to write a changelog?, this documentation will give you all the guide lines to create an efficient README.

But, if you have to share more informations, don't hesitate to create a more complete documentation in your project and expose it through link or by creating a documentation with MkDocs, Read the Docs ...


Also to help you to create your README, there is a ton a really cool tools to use, such as

  • ReadMe.so : To create your README with an online editor Image description
  • Git badges : To display some important informations as badges Image description
  • Github Stats : To display some informations about your github stats Img

... and so on!

You can check online, there is a bunch of tools and some git projects are listing them :


Now you have all the tools to create an efficient README! 🚀

If you need more inspiration, don't hesitate to check README files from other projects or check some posts. There is a lot of posts online which are talking about cool README designs.

I hope it will help you! 🍺


You want to support me?

Buy Me A Coffee

Top comments (0)