DEV Community

Add this to your project's README for maximum impact

Nick Tchemitcheff on November 18, 2019

You work hard to put together projects that you share with the world live and on Github/Codepen/Codesandbox in hope one day to show potential emplo...
Collapse
 
daviddalbusco profile image
David Dal Busco

Thank you for sharing this list!

In our case one information which was often requested to be added was a CONTRIBUTING guide to our project. If that's maybe too much information to be displayed in the README, it's probably good to link or reference it too.

Badges from Shields.io is a good way to summarize info too. I recently landed on the Postwoman project's README and I think it's a nice usage of badges. Notably the way they display the last release date, which would match your good idea of displaying TIMESTAMP.

[![GitHub release](https://img.shields.io/github/release/yourproject/all?logo=GitHub)](https://github.com/yourproject/releases/latest)
Collapse
 
usaspiff profile image
Nick Tchemitcheff

This Postwoman's README is slick! Great example.

Collapse
 
liyasthomas profile image
Liyas Thomas

Thank you 😄

Collapse
 
artyomgazizyanov profile image
Artemiy Gazizyanov

Thank you for this post!
Usually, I used README only as an instruction 'How to run ...'. I saw othersREADME, but didn't much pay attention to the ways of how they formate it.
So I will try tips, which you provided, in my next project
s README file, to make it more readable and full.

Collapse
 
nerajno profile image
Nerando Johnson

I wrote almost the same blog, Love it though

Collapse
 
usaspiff profile image
Nick Tchemitcheff

Oh wow, yes. Love your post, more detailed and structured. Bookmarked. Glad I didn't see it first, it might have scared me off from writing my first post :)

Collapse
 
awwsmm profile image
Andrew (he/him)

Great tips, Nick! I also try to add code coverage, CI, and documentation badges to any of my serious projects.

Bookmarked!

Collapse
 
jpchateau profile image
Jean-Philippe Chateau

Indeed, a well designed Readme is necessary for an open source software. To go further, here is a well-known list of awesome readme: github.com/matiassingers/awesome-r...