Ranter
Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Comments
-
0. clearly structured document (0, 1, 2 lvl headers where applicable)
1. what does it do? what's its purpose? what it's not meant for? Depending on the context, HOW does it do it would also be of interest (e.g. Spring IoC vs Dagger2 projects do the same but in a very different way that makes Spring a poor choice for android whereas Dagger2 is the perfect fit)
2. dependencies (!!!), if applicable - including actual version numbers
3. how to install that thing
4. usage examples would be nice. The "Hello world" part and the most tricky parts.
5. licence, if applicable
The best READMEs I've seen have all of the above. In that order. Other sections I usually skip. -
You think this is okay, or should I change something?
https://github.com/thosebeans/dotpm -
rabbi16186yA link to a working demo if there is something to see, or a gif if it is a cli program
-
Fradow9166y@metamourge Installation and dependencies parts should be way higher, I almost thought you forgot them since they were so low. At least before "Usage".
You also have a typo on "dependencies" title (you spelled it "dependecies" -
mishaor17906y# <title>
<Fancy badges>
<Detailed explanation what it is>
# Installation
On <platform name>:
<Shell commands (preferred) or GUI installation instructions>
# Usage
<Quick, surface-level "How to use my program" guide>
# Contributing
<What and how branches are used, do I need to sign a CLA, etc.>
Related Rants
What makes a good README.md for you ?
question
readme.md
github