README tips and feedback [Accessibility Skills Week Four]

[queenofcorgis]

Your profile page on GitHub tells people who you are, what you’ve worked on, and what you’re interested in and allows you to add your unique flair. Making sure it’s built with all folks in mind so anyone can navigate and interact with it is key.

What do I consider when making my README accessible 👀 ?

The good news, if you’ve been participating these past few weeks in our Skills Challenges you have the tools for the job (and if not, you can go back at any point), review or update your .md file for the following:

• Image alt text
• Links
• Emojis and plain language

Resources 🎒

• Tips for Making your GitHub Profile Page Accessible in the GitHub Community
• Setting up your profile from the GitHub Docs

Examples 🖼️

• @queenofcorgi’s GitHub profile
• @brittanyellich’s GitHub profile
• @cehfisher’s GitHub profile

Share your updated profile below for feedback and inspiration to others.

*No Purchase Necessary. The prize draw is open to verified registered students of GitHub Education who are at least 13 years old. Game ends 5/15/25. For details, see Official Rules.

[Vivek09Chahal]

@Vivek's GitHub Profile
Day before yesterday only I updated my profile 😁 and make it look like professional. So that, it can help in selection process of interviews.🥲

[queenofcorgis]

WOW - it certainly does look professional 💼 . I think you could make it more accessible by including alt text for your header image (if you haven't already) and adding more context to the links here:

Beyond iOS Development, my technical exploration extends in development field, including Android APP Development, Windows App Development. And Game Development as well.

Great work!

[Vivek09Chahal]

Those links are just taking to the main page of their respective websites. For example, Android APP Development take it to developer.android.com website.😅

[Vivek09Chahal]

Here you can check this reel of GitHub on instagram, they have suggest the best practice.
Best Practice to Make README for job profile

[melvincwng]

@melvincwng's GitHub Profile

Here's my profile - feel free to follow for inspiration 😃

[queenofcorgis]

Very cool, loved the quotes section adds a really nice human feel to your profile. For the buttons, I recommend adding alt text for each image. You can do this in Markdown or as an alt attribute. All the alt text needs to be is the same text you visually see so:

• Markdown: ![Swift](image-url)
• Alt attribute: <img alt="Buy me a coffee" src="image-url"

[Juleipssy]

Hello, I hope you're all doing well! Here’s my GitHub profile — I hope you like it! 😊

[queenofcorgis]

This reads very cleanly @Juleipssy ❤️ . Same note in my comment above about the buttons and I'd also recommend swapping the emojis to be at the end of sentences for a better screenreader experience.

[Seb0927]

@Seb0927's Github Profile

Hope you can enjoy it!

[Seb0927]

I'd like to ask a question: Since a long time I've been using Kaomojis because I find them really fun! But a screen reader just reads those as characters losing all the meaning to the user. Is there any solution for this particular situation? Thank you in advance 😄

[queenofcorgis]

Very straightforward and to the point - this is an excellent snapshot to get to know about you and great emoji placement 😃 .

For the Kaomojis I would experiment with using alt text in a few different arrangements to ensure even a screenreader user could have the same context.

[allubie]

@allubie's Github Profile

took some inspiration from @Seb0927's profile .

[queenofcorgis]

That's awesome you used another profile for inspiration ❤️

Do you have alt text for your icons, that would be a great addition!

[allubie]

yes , I've added alt text for all icons. I learned a lot through the skills week.

[Salgado2004]

@Salgado2004's GitHub Profile

I enjoyed this challenge! I actually needed to update my readme and you gave me the motivation to do it! Thank you @queenofcorgis 😊

[queenofcorgis]

@Salgado2004 woah look all those certifications! I think maybe adding to your header alt the context it is a header is all you're missing! Thanks for participating Leo!

[Protik49]

Here's my GitHub profile — trying to improve every day.

[queenofcorgis]

Very snazzy @Protik49 - make sure you have an accessible way to view the interactive stats on your profile 😄

[FranciscoLDB]

Here's my GitHub profile.

Every time I update my read.me I feel a sense of peace, which will only last a few weeks until I have another update to do. 🥲

[queenofcorgis]

Nice work @FranciscoLDB - love that you called out the post you used to encourage others to do the same!

[queenofcorgis]

Thank you all for the hard work building your accessibility skills over the past four weeks, now that Global Accessibility Awareness Day is just days a way, it is time to start celebrating with our Five different ways you can use GitHub Copilot video campaign.

Each day, we’ll spotlight a new video and topic featuring a person with lived experience using GitHub Copilot to solve real-world challenges — whether personal or professional.

Kicking us off is Vytautas, a screen reader user who codes in Visual Studio Code with GitHub Copilot by his side! Watch as Copilot helps him move faster and work smoother — turning a complex editing process into a streamlined flow 🚀

[Namgay282004]

Here is my Github Profile: your feedback would be greatly appreciated:))