README files are text files that simply contain information about their directory. They explain why the project is useful, what kinds of files it may have, its history, or any other relevant points worth elaborating.
GitHub.com uses Markdown extensively within its ecosystem for documentation; README files and Issues postings are written using Markdown.
Files and Directories
README.md file is put in a repository’s root directory, GitHub will recognize and automatically surface your README to repository visitors - meaning it’s the first thing they’ll see, with no extra clicking.
. └── assignment-01/ └── README.md
Don’t worry if this doesn’t quite make sense yet: we can provide an example! Go ahead, check ours out.