---
title: "Comment by Omezibe Obioha on \"The Unsung Hero of Projects: The README File\" | Hashnode"
description: "Well put! Bland/no README is definitely an off-putter for me while checking out a project on GitHub (I mean, why open source what someone can't understand it's"
url: "https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5/comment/65c17d66b342d0fae62858b3"
---

[Discussion](https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5)

Comment [The Unsung Hero of Projects: The README File](https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5)

[Omezibe Obioha](https://hashnode.com/@omzi)

[Feb 6, 2024](https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5/comment/65c17d66b342d0fae62858b3)

Well put! Bland/no README is definitely an off-putter for me while checking out a project on GitHub (I mean, why open source what someone can't understand it's purpose at a glance?. My key takeaway from your README template is the TOC 😅. I pretty much do everything else in yours already (check out my latest project on GitHub: [HashBot](https://github.com/omzi/hashbot)). Do you come up with the header IDs yourself? If yes, how do you handle emojis in headers? Thanks.

PS: I tried playing your Battleship game but couldn't figure out how it works ;(.

[Scott Wright](https://hashnode.com/@scottwright)

[Feb 9, 2024](https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5/comment/65c17d66b342d0fae62858b3#reply-65c65943ed5f825ce45a2fa0)

Hey [Omezibe Obioha](https://hashnode.com/@omzi), thanks for the comment!

The TOC is something I used for this project in particular because the readme got quite detailed and overwhelming as one piece. Had to break it up a little. 😅

I just chose the headers based on what I thought best described the content to be honest.

In regards to emojis in readmes, do you mean like on my github profile?

I used this generator for that: [profileme.dev](https://www.profileme.dev/) 👍

Lastly, thanks for the feedback on the Battleship game. I'd be interested to know what wasn't working for you, if you have the time could you let me know what browser/device where you using etc?

Always helpful to get some feedback from real world use.

[Omezibe Obioha](https://hashnode.com/@omzi)

[Feb 11, 2024](https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5/comment/65c17d66b342d0fae62858b3#reply-65c8b77852cc60d2f19fa59d)

Don't mention it [Scott Wright](https://hashnode.com/@scottwright) ✌🏽.

Regarding the emojis, I meant like on a project README. From my quick "research", I found out that GitHub auto-generates a TOC & removes emojis from the ID. It's an easy-to-miss feature, so having your own TOC is best for now.

Just seeing [profileme.dev](https://profileme.dev/) for the first time. Cool stuff! Thanks for the recommendation.

Lastly, the only issue I had with Battleship was I didn't know how to play it ;). No instructions. I think that's similar to not having a README in a repo yeah 😅?

[Scott Wright](https://hashnode.com/@scottwright)

[Feb 11, 2024](https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5/comment/65c17d66b342d0fae62858b3#reply-65c92f55658ee24faf31713a)

[Omezibe Obioha](https://hashnode.com/@omzi) You make a good point 😅! I should add some instructions to the repo, thats really helpful feedback so I'm definitely going to add them. Really appreciate that!

[Omezibe Obioha](https://hashnode.com/@omzi)

[Feb 11, 2024](https://hashnode.com/posts/the-unsung-hero-of-projects-the-readme-file/65be1fd9a036c7b72761fda5/comment/65c17d66b342d0fae62858b3#reply-65c94554d8a59626d0d1194f)

[Scott Wright](https://hashnode.com/@scottwright) Haha, you're welcome 😁
