DEV Community

Cover image for How I write a README.md for my Github projects
David Mendoza (He/Him)
David Mendoza (He/Him)

Posted on • Edited on

19 5

How I write a README.md for my Github projects

Hello guys, once again I'm here with a small tutorial for you guys new on the business. Even though my repos have never got a lot of attention, I like that they have a good readme.

Knowing that lets just go to the point.

Before publish your own README

let me tell you what you need to change, you will see that they are some and . well that's where you will change to your Github user and to your Github repo name.

Plus you will see some quick explanation saying what you should put there, they are marked with this [ ].

With nothing else to say, take a look.

Here is a picture of the markdown code

Alt Text

And here you can get the raw code

[Repo name] made with ❤️,☕ and some 🍺

[here we add the necesary badges, here are the ones I say we always need]

License Issues forks stars size

[short description of the repo]

this app is made for myself

Motivation ❓

[Just a quick explanation about why you are making this project]

just for fun and learning

Installation 📥

[Here you will place the necessary commands to clone and run your project]

> git clone https://github.com/<User>/<Repo>

>  cd  <Repo>

> npm install

> npm start

Bugs 🐛

[Here you will place what to do if someone have a bug, and they will report it]

This project is getting upgrades in my free time if there is a problem please create a bug report in the issues section.

License 📜

[Here you simply, add your repos license name]

view raw README.md hosted with ❤ by GitHub

Top comments (4)

Collapse
 
sansseryph profile image
Kyla

This is great! For projects that have collaborators, I like to add a Code of Conduct as well.

Collapse
 
mendoza profile image
David Mendoza (He/Him)

Thanks! Actually there are some good basic code of conducts, that people use, I think one is atom's one

Collapse
 
jinglescode profile image
Jingles (Hong Jing)

Thanks!

Collapse
 
zaidmaker profile image
DevMirza

Amazing 😍👌😍

AWS Security LIVE!

Join us for AWS Security LIVE!

Discover the future of cloud security. Tune in live for trends, tips, and solutions from AWS and AWS Partners.

Learn More