DEV Community

Discussion on: How to write a good README? #discuss

Collapse
 
michaeldimmitt profile image
MichaelDimmitt

Hope some of this info adds to the discussion.

Often a gif can be super-helpful to show how a project functions.
Example: github.com/MichaelDimmitt/gh_reveal

An image can likewise provide benefit.
Example: github.com/JohnCoates/Aerial

Logos or other images are also nice, they make the document more fun and less of a pain to read.
github.com/hashrocket/decent_exposure

Also, people often like the "shields" to show numbers like num downloads/week or tests passing.
shields.io/#/

Happy to add to the discussion further.
Mac app I like to use, Giphy Capture, for making gif's