Writing a README file

I used to checkout the Add a README file
checkbox whenever I create a new repo because I thought it was a useless file (It may have thought the same about my project). But now I understand its importance.
Why README file
README file is the face of your repo. Haven't heard that judgmental proverb Face is the index of the mind
. People are not going to read each and every file to know what the project is about. The title 'final year project' never tells everything about your project (It needs an Asian kid's level IQ to get info just by the title). So it is crucial to write a good README file so that people can skip your project at first glance ๐.
Should contain
Here is a list of contents that should be present in a project repo
Project Title
Description
Technology used (If any ๐๐ป)
How to use
API Refs
Optional
Build Status
Screenshots
Cool stuffs
Shields
, yes something like this; You can find this in shield.io and use it using
<img>
tagDemo gif of your project working (videos won't work in git README)

- While adding code blocks, you should consider using
js [enter][CODE]
like this. Because most markdown supports coding languages and it will be easy to read for programmers. It adds text colors ๐
function uptown(){
var day = "Saturday";
console.log(day+" night and we in the spot");
}
- Using HTML tags - You can use some basic html tags to build elements like
<h1 align="center">you know who I am</h1>
you know who I am
Linking Contents
We can link that can guide to a specific part of the file. use #
to select the heading of the content like this
[Intro](#writing-a-readme-file)
Interesting Reads
Conclusion
There are more, but I feel these are the most important ones or I'm not ready to spend more time on this. I forget where I read these things, but thanks to that person. And... yeah, that's it (this conclusion is just a formal thing no useful information here)
Subscribe to my newsletter
Read articles from Zuko dev directly inside your inbox. Subscribe to the newsletter, and don't miss out.
Written by
