Skip to content

Refactor README for improved clarity and structure#458

Merged
rainxchzed merged 4 commits into
OpenHub-Store:mainfrom
nxfu:main
Apr 26, 2026
Merged

Refactor README for improved clarity and structure#458
rainxchzed merged 4 commits into
OpenHub-Store:mainfrom
nxfu:main

Conversation

@nxfu
Copy link
Copy Markdown
Contributor

@nxfu nxfu commented Apr 25, 2026

Updated README.md to enhance formatting and add new sections.

Summary by CodeRabbit

  • Documentation
    • Revamped README header: replaced badge cluster with new badge set and updated download/stars/issues/latest-release links.
    • Added a prominent "Support Palestine" banner near the top.
    • Replaced screenshot strip with a 2×3 screenshot table for clearer previews.
    • Converted two explainer sections into collapsible FAQ blocks.
    • Repositioned sections (Featured In, Meet the Developer, Discord, Wiki & Legal), modernized Download layout, and added a "❤️ Support This Project" section with Star/Report/Suggest/Sponsor links; minor formatting tweaks.

Updated README.md to enhance formatting and add new sections.
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 25, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 87355cdf-6b64-4251-bd03-ccfabb5e8a63

📥 Commits

Reviewing files that changed from the base of the PR and between 1f74437 and 26d4b99.

📒 Files selected for processing (1)
  • README.md

Walkthrough

Reworks README layout: replaces initial badge cluster with new badges, adds a "Support Palestine" banner near the top, converts two sections into collapsible FAQs, replaces screenshot thumbnails with a 2×3 table, reorders several sections, and adds a "❤️ Support This Project" area; also normalizes markup/whitespace.

Changes

Cohort / File(s) Summary
README Layout & Content Restructuring
README.md
Replaced top badge cluster with badges from ziadoua.github.io and api.github-store.org; updated Downloads/Stars/Issues/Latest-release badge URLs and download badge markup/sizing; inserted "Support Palestine" banner near top; moved/removed then reintroduced "Meet the Developer", "Wiki & Resources", "Legal Notice", "Discord", and "Featured In" blocks; converted "How does my app appear…" and "Pros / Why use GitHub Store?" into <details> FAQ sections; changed screenshot presentation to a 2×3 Markdown table; added "❤️ Support This Project" section with Star/Report/Suggest/Sponsor links; repositioned and rewrote Legal Notice; minor whitespace/HTML indentation normalization.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

🐰
I hopped through badges, lines, and light,
Folded FAQs into the night,
Screens in tidy rows I place,
A banner here, a friendly space,
Click a star — my joyful pace ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Refactor README for improved clarity and structure' is directly related to the main change: restructuring and reformatting the README.md file with new sections, reorganized content, updated badges, and improved presentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 87-92: The two download badge <img> tags for the GitHub badge
(src="https://i.ibb.co/q0mdc4Z/get-it-on-github.png") and the F-Droid badge
(src="https://f-droid.org/badge/get-it-on.png") are missing alt attributes;
update those <img> elements in the README to include descriptive alt text (e.g.,
alt="Get it on GitHub" and alt="Get it on F-Droid") so they match the
Obtainium/GitHub Store badges and improve accessibility.
- Around line 67-76: The images lack alt text which makes them inaccessible;
update the banner <img src="media-resources/banner.jpeg" width="99%" /> and each
table cell image ![](media-resources/screenshots/mobile/01.jpg) through
![](media-resources/screenshots/mobile/06.jpg) to include concise, descriptive
alt attributes (e.g., alt="Banner: [brief description]" and alt="Screenshot 1:
[brief description]" … "Screenshot 6: [brief description]") reflecting the
actual visual content so screen readers can convey their meaning.
- Around line 10-32: The badge images in README.md lack alt text which breaks
accessibility; update every <img> tag in the shown badge block (e.g., the Kotlin
badge, Apache-2.0 badge, Android/Windows/macOS/Linux badges,
downloads/stars/issues/release badges) to include meaningful alt attributes such
as "Kotlin badge", "Apache-2.0 license badge", "Android badge", "Windows badge",
"macOS badge", "Linux badge", "Downloads badge for OpenHub-Store/GitHub-Store",
"Stars badge for OpenHub-Store/GitHub-Store", "Issues badge for
OpenHub-Store/GitHub-Store", and "Release badge for OpenHub-Store/GitHub-Store"
so screen readers can convey their purpose.
- Around line 278-280: The Discord widget image tag is missing alt text; update
the <img> element inside the Discord link (the img with
src="https://invidget.switchblade.xyz/NBW4zeFcG6") to include a meaningful alt
attribute (e.g., alt="Discord server widget for NBW4zeFcG6" or alt="Join our
Discord server") so screen readers can describe the image for accessibility.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 4444a6a7-c088-46eb-94c6-f4dd2f515424

📥 Commits

Reviewing files that changed from the base of the PR and between 3c77daf and 64eb24f.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
Comment thread README.md
Comment on lines +67 to +76
<img src="media-resources/banner.jpeg" width="99%" />
</p>

<div align="center">
| 1 | 2 | 3 |
| --- | --- | --- |
| ![](media-resources/screenshots/mobile/01.jpg) | ![](media-resources/screenshots/mobile/02.jpg) | ![](media-resources/screenshots/mobile/03.jpg) |

# 📔 Wiki & Resources

Check out GitHub Store [Wiki](https://github.com/OpenHub-Store/GitHub-Store/wiki) for FAQ and useful information

🌐 **Website:** [github-store.org](https://github-store.org)
💬 **Discord:** [Join the community](https://discord.gg/x9Cvh2Z9qS)
📜 **Privacy Policy:** [github-store.org/privacy-policy](https://github-store.org/privacy-policy/)

</div>
| 4 | 5 | 6 |
| --- | --- | --- |
| ![](media-resources/screenshots/mobile/04.jpg) | ![](media-resources/screenshots/mobile/05.jpg) | ![](media-resources/screenshots/mobile/06.jpg) |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Add descriptive alt text to banner and screenshot images.

The banner image and all six screenshot images in the table lack alt text, making the visual content inaccessible to screen reader users.

♿ Proposed fix for banner and screenshots
 <p align="center">
-  <img src="media-resources/banner.jpeg" width="99%" />
+  <img alt="GitHub Store app banner" src="media-resources/banner.jpeg" width="99%" />
 </p>

 | 1 | 2 | 3 |
 | --- | --- | --- |
-| ![](media-resources/screenshots/mobile/01.jpg) | ![](media-resources/screenshots/mobile/02.jpg) | ![](media-resources/screenshots/mobile/03.jpg) |
+| ![Home screen showing trending repositories](media-resources/screenshots/mobile/01.jpg) | ![Repository details with release information](media-resources/screenshots/mobile/02.jpg) | ![App installation screen](media-resources/screenshots/mobile/03.jpg) |

 | 4 | 5 | 6 |
 | --- | --- | --- |
-| ![](media-resources/screenshots/mobile/04.jpg) | ![](media-resources/screenshots/mobile/05.jpg) | ![](media-resources/screenshots/mobile/06.jpg) |
+| ![Installed apps management](media-resources/screenshots/mobile/04.jpg) | ![Settings and customization](media-resources/screenshots/mobile/05.jpg) | ![Search and filters](media-resources/screenshots/mobile/06.jpg) |

Note: Adjust the alt text descriptions based on what each screenshot actually shows.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<img src="media-resources/banner.jpeg" width="99%" />
</p>
<div align="center">
| 1 | 2 | 3 |
| --- | --- | --- |
| ![](media-resources/screenshots/mobile/01.jpg) | ![](media-resources/screenshots/mobile/02.jpg) | ![](media-resources/screenshots/mobile/03.jpg) |
# 📔 Wiki & Resources
Check out GitHub Store [Wiki](https://github.com/OpenHub-Store/GitHub-Store/wiki) for FAQ and useful information
🌐 **Website:** [github-store.org](https://github-store.org)
💬 **Discord:** [Join the community](https://discord.gg/x9Cvh2Z9qS)
📜 **Privacy Policy:** [github-store.org/privacy-policy](https://github-store.org/privacy-policy/)
</div>
| 4 | 5 | 6 |
| --- | --- | --- |
| ![](media-resources/screenshots/mobile/04.jpg) | ![](media-resources/screenshots/mobile/05.jpg) | ![](media-resources/screenshots/mobile/06.jpg) |
<img alt="GitHub Store app banner" src="media-resources/banner.jpeg" width="99%" />
</p>
| 1 | 2 | 3 |
| --- | --- | --- |
| ![Home screen showing trending repositories](media-resources/screenshots/mobile/01.jpg) | ![Repository details with release information](media-resources/screenshots/mobile/02.jpg) | ![App installation screen](media-resources/screenshots/mobile/03.jpg) |
| 4 | 5 | 6 |
| --- | --- | --- |
| ![Installed apps management](media-resources/screenshots/mobile/04.jpg) | ![Settings and customization](media-resources/screenshots/mobile/05.jpg) | ![Search and filters](media-resources/screenshots/mobile/06.jpg) |
🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 67-67: Images should have alternate text (alt text)

(MD045, no-alt-text)


[warning] 72-72: Images should have alternate text (alt text)

(MD045, no-alt-text)


[warning] 72-72: Images should have alternate text (alt text)

(MD045, no-alt-text)


[warning] 72-72: Images should have alternate text (alt text)

(MD045, no-alt-text)


[warning] 76-76: Images should have alternate text (alt text)

(MD045, no-alt-text)


[warning] 76-76: Images should have alternate text (alt text)

(MD045, no-alt-text)


[warning] 76-76: Images should have alternate text (alt text)

(MD045, no-alt-text)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 67 - 76, The images lack alt text which makes them
inaccessible; update the banner <img src="media-resources/banner.jpeg"
width="99%" /> and each table cell image
![](media-resources/screenshots/mobile/01.jpg) through
![](media-resources/screenshots/mobile/06.jpg) to include concise, descriptive
alt attributes (e.g., alt="Banner: [brief description]" and alt="Screenshot 1:
[brief description]" … "Screenshot 6: [brief description]") reflecting the
actual visual content so screen readers can convey their meaning.

Comment thread README.md
Comment thread README.md
Comment on lines +278 to +280
<a href="https://discord.gg/NBW4zeFcG6">
<img src="https://invidget.switchblade.xyz/NBW4zeFcG6" />
</a>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Add alt text to Discord server widget image.

The Discord server widget image lacks alt text, making it inaccessible to screen reader users.

♿ Proposed fix
   <a href="https://discord.gg/NBW4zeFcG6">
-    <img src="https://invidget.switchblade.xyz/NBW4zeFcG6" />
+    <img alt="Join GitHub Store Discord Server" src="https://invidget.switchblade.xyz/NBW4zeFcG6" />
   </a>
🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 279-279: Images should have alternate text (alt text)

(MD045, no-alt-text)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 278 - 280, The Discord widget image tag is missing
alt text; update the <img> element inside the Discord link (the img with
src="https://invidget.switchblade.xyz/NBW4zeFcG6") to include a meaningful alt
attribute (e.g., alt="Discord server widget for NBW4zeFcG6" or alt="Join our
Discord server") so screen readers can describe the image for accessibility.

@nxfu
Copy link
Copy Markdown
Contributor Author

nxfu commented Apr 25, 2026

@coderabbitai help

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 25, 2026

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

CodeRabbit commands

These commands are invoked using PR/Issue comments.

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai evaluate custom pre-merge check --instructions <custom-checks-instructions> --name <custom-checks-title> [--mode <error|warning>] to validate the custom pre-merge checks instructions. Defaults to error when --mode is omitted.
  • @coderabbitai ignore pre-merge checks to override pre-merge checks and get an approval on PR.
  • @coderabbitai run pre-merge checks to run pre-merge checks on the pull request.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve merge conflict to automatically resolve merge conflicts.
  • @coderabbitai autofix to automatically fix issues identified in unresolved review comments.
  • @coderabbitai resolve to resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai generate configuration to create a PR that adds the current resolved configuration as .coderabbit.yaml (or show it if already present).
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Status, support, documentation and community

  • Visit our status page to check the current availability of CodeRabbit.
  • Create a ticket on our support page for assistance with any issues or questions.
  • Visit our documentation site for detailed information on how to use CodeRabbit.
  • Join our Discord community to connect with other users and get help from the community.
  • Follow us on X/Twitter for updates and announcements.

Updated badge links in README.md to include alt text.
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

♻️ Duplicate comments (4)
README.md (4)

279-279: ⚠️ Potential issue | 🟠 Major

Discord widget image is missing alt text (Line 279).

The image in the Discord section should include a readable alt label.

Proposed fix
-    <img src="https://invidget.switchblade.xyz/NBW4zeFcG6" />
+    <img src="https://invidget.switchblade.xyz/NBW4zeFcG6" alt="Join the GitHub Store Discord server" />
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 279, The Discord widget image tag lacks an accessible alt
attribute; update the <img> element (the Discord widget line containing
src="https://invidget.switchblade.xyz/NBW4zeFcG6") to include a meaningful alt
text (e.g., alt="Discord widget for [server name]" or alt="Discord member count
and online status") so screen readers can describe the image.

88-88: ⚠️ Potential issue | 🟠 Major

Download badge images are still missing alt text (Lines 88, 91).

Both linked images should include meaningful alt attributes for accessibility consistency.

Proposed fix
-    <img src="https://i.ibb.co/q0mdc4Z/get-it-on-github.png" height="80" />
+    <img src="https://i.ibb.co/q0mdc4Z/get-it-on-github.png" height="80" alt="Get it on GitHub" />
...
-    <img src="https://f-droid.org/badge/get-it-on.png" height="80" />
+    <img src="https://f-droid.org/badge/get-it-on.png" height="80" alt="Get it on F-Droid" />

Also applies to: 91-91

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 88, The two badge <img> elements (e.g., the one with src
"https://i.ibb.co/q0mdc4Z/get-it-on-github.png" and the other badge at the same
section) are missing alt text; update each <img> tag to include a meaningful alt
attribute (for example "Get it on GitHub" or similar descriptive text) so both
images provide accessible descriptions.

14-17: ⚠️ Potential issue | 🟠 Major

Platform badge images still miss alt text (Lines 14–17).

These badges are not accessible without alt attributes.

Proposed fix
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Android/android1.svg" />
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Windows/windows1.svg" />
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/macOS/macos1.svg" />
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Linux/linux2.svg" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Android/android1.svg" alt="Android badge" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Windows/windows1.svg" alt="Windows badge" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/macOS/macos1.svg" alt="macOS badge" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Linux/linux2.svg" alt="Linux badge" />
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 14 - 17, The four <img> badge elements for Android,
Windows, macOS, and Linux are missing alt attributes; update each <img> tag (the
ones using ziadoua.github.io/m3-Markdown-Badges URLs) to include concise,
descriptive alt text (e.g., alt="Android badge", alt="Windows badge", alt="macOS
badge", alt="Linux badge") so the badges are accessible to screen readers and
meet accessibility standards.

67-67: ⚠️ Potential issue | 🟠 Major

Banner and screenshot images still lack descriptive alt text (Lines 67, 72, 76).

<img> and markdown images with empty ![](...) remain inaccessible.

Proposed fix
-  <img src="media-resources/banner.jpeg" width="99%" />
+  <img src="media-resources/banner.jpeg" width="99%" alt="GitHub Store promotional banner" />
...
-| ![](media-resources/screenshots/mobile/01.jpg) | ![](media-resources/screenshots/mobile/02.jpg) | ![](media-resources/screenshots/mobile/03.jpg) |
+| ![Screenshot 1](media-resources/screenshots/mobile/01.jpg) | ![Screenshot 2](media-resources/screenshots/mobile/02.jpg) | ![Screenshot 3](media-resources/screenshots/mobile/03.jpg) |
...
-| ![](media-resources/screenshots/mobile/04.jpg) | ![](media-resources/screenshots/mobile/05.jpg) | ![](media-resources/screenshots/mobile/06.jpg) |
+| ![Screenshot 4](media-resources/screenshots/mobile/04.jpg) | ![Screenshot 5](media-resources/screenshots/mobile/05.jpg) | ![Screenshot 6](media-resources/screenshots/mobile/06.jpg) |

Also applies to: 72-72, 76-76

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 67, Update the empty alt text for the images referenced in
README.md: replace the HTML <img src="media-resources/banner.jpeg" width="99%"
/> with an accessible <img> that includes a descriptive alt attribute (e.g.,
alt="Project banner showing ..."), and replace any markdown image occurrences
using ![](...) with descriptive alt text like ![Screenshot of
...](media-resources/...), ensuring each image (banner and the two screenshots)
has a meaningful alt string describing the content and purpose.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 3: The header image tag in README.md is missing an alt attribute which
prevents screen readers from announcing it; update the <img
src="media-resources/app_icon.png" width="200" /> element to include a
meaningful alt text (e.g., alt="App icon" or a more descriptive phrase like
alt="MyApp logo") so assistive technologies can convey its purpose.

---

Duplicate comments:
In `@README.md`:
- Line 279: The Discord widget image tag lacks an accessible alt attribute;
update the <img> element (the Discord widget line containing
src="https://invidget.switchblade.xyz/NBW4zeFcG6") to include a meaningful alt
text (e.g., alt="Discord widget for [server name]" or alt="Discord member count
and online status") so screen readers can describe the image.
- Line 88: The two badge <img> elements (e.g., the one with src
"https://i.ibb.co/q0mdc4Z/get-it-on-github.png" and the other badge at the same
section) are missing alt text; update each <img> tag to include a meaningful alt
attribute (for example "Get it on GitHub" or similar descriptive text) so both
images provide accessible descriptions.
- Around line 14-17: The four <img> badge elements for Android, Windows, macOS,
and Linux are missing alt attributes; update each <img> tag (the ones using
ziadoua.github.io/m3-Markdown-Badges URLs) to include concise, descriptive alt
text (e.g., alt="Android badge", alt="Windows badge", alt="macOS badge",
alt="Linux badge") so the badges are accessible to screen readers and meet
accessibility standards.
- Line 67: Update the empty alt text for the images referenced in README.md:
replace the HTML <img src="media-resources/banner.jpeg" width="99%" /> with an
accessible <img> that includes a descriptive alt attribute (e.g., alt="Project
banner showing ..."), and replace any markdown image occurrences using ![](...)
with descriptive alt text like ![Screenshot of ...](media-resources/...),
ensuring each image (banner and the two screenshots) has a meaningful alt string
describing the content and purpose.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: ab0d2b2f-b6f1-4cc4-b268-9770749e737b

📥 Commits

Reviewing files that changed from the base of the PR and between 64eb24f and 1b92692.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md Outdated
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

♻️ Duplicate comments (4)
README.md (4)

279-279: ⚠️ Potential issue | 🟠 Major

Discord widget image is missing alt text.

Line 279 still has an <img> without alt, which is inaccessible for screen readers and duplicates an earlier finding.

Proposed fix
-    <img src="https://invidget.switchblade.xyz/NBW4zeFcG6" />
+    <img src="https://invidget.switchblade.xyz/NBW4zeFcG6" alt="Join the GitHub Store Discord server" />
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 279, The Discord widget <img> tag with src
"https://invidget.switchblade.xyz/NBW4zeFcG6" is missing an alt attribute;
update that <img> element to include a meaningful alt text (e.g., alt="Discord
server widget showing member/activity stats") to improve accessibility and avoid
duplication of the earlier missing-alt finding.

88-88: ⚠️ Potential issue | 🟠 Major

Add alt text to GitHub and F-Droid download badges.

The images on Line 88 and Line 91 are missing alt values. This is the same accessibility issue previously identified for this section.

Proposed fix
-    <img src="https://i.ibb.co/q0mdc4Z/get-it-on-github.png" height="80" />
+    <img src="https://i.ibb.co/q0mdc4Z/get-it-on-github.png" height="80" alt="Get it on GitHub" />
...
-    <img src="https://f-droid.org/badge/get-it-on.png" height="80" />
+    <img src="https://f-droid.org/badge/get-it-on.png" height="80" alt="Get it on F-Droid" />

Also applies to: 91-91

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 88, The GitHub and F-Droid badge images are missing alt
text; update the two <img> elements (e.g., the one with src
"https://i.ibb.co/q0mdc4Z/get-it-on-github.png" and the other F-Droid badge
image on Line 91) to include meaningful alt attributes like alt="Get it on
GitHub" and alt="Get it on F‑Droid" respectively so the badges are accessible to
screen readers.

14-17: ⚠️ Potential issue | 🟠 Major

Add alt text for platform badge images.

Lines 14–17 still use <img> tags without alt, so screen readers won’t announce these badges. This was already flagged earlier and appears reintroduced.

Proposed fix
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Android/android1.svg" />
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Windows/windows1.svg" />
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/macOS/macos1.svg" />
-  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Linux/linux2.svg" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Android/android1.svg" alt="Android badge" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Windows/windows1.svg" alt="Windows badge" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/macOS/macos1.svg" alt="macOS badge" />
+  <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Linux/linux2.svg" alt="Linux badge" />
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 14 - 17, The README's platform badge <img> elements
lack alt attributes, which hurts accessibility; update each badge <img> tag (the
Android, Windows, macOS, Linux badge images shown) to include a meaningful alt
text like "Android badge", "Windows badge", "macOS badge", and "Linux badge"
respectively so screen readers can announce them.

67-67: ⚠️ Potential issue | 🟠 Major

Banner and screenshot images need descriptive alt text.

Line 67 and the screenshot cells on Lines 72 and 76 still use empty alt text syntax, which is an accessibility gap and matches a previously reported issue.

Proposed fix
-  <img src="media-resources/banner.jpeg" width="99%" />
+  <img src="media-resources/banner.jpeg" width="99%" alt="GitHub Store banner" />

-| ![](media-resources/screenshots/mobile/01.jpg) | ![](media-resources/screenshots/mobile/02.jpg) | ![](media-resources/screenshots/mobile/03.jpg) |
+| ![Screenshot 1](media-resources/screenshots/mobile/01.jpg) | ![Screenshot 2](media-resources/screenshots/mobile/02.jpg) | ![Screenshot 3](media-resources/screenshots/mobile/03.jpg) |

-| ![](media-resources/screenshots/mobile/04.jpg) | ![](media-resources/screenshots/mobile/05.jpg) | ![](media-resources/screenshots/mobile/06.jpg) |
+| ![Screenshot 4](media-resources/screenshots/mobile/04.jpg) | ![Screenshot 5](media-resources/screenshots/mobile/05.jpg) | ![Screenshot 6](media-resources/screenshots/mobile/06.jpg) |

Also applies to: 72-72, 76-76

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 67, The README contains <img> tags (e.g., the banner image
tag shown and the screenshot image cells) with empty alt attributes; update
those image elements to include concise, descriptive alt text that describes the
image content and purpose (for example replace alt="" with alt="Project banner
showing X" or alt="Screenshot of Y feature") for the banner and the screenshots
referenced in the README to satisfy accessibility requirements.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 360: The "⭐ **[Star](.../star)**" markdown link in README.md points to a
nonstandard "/star" route causing a broken CTA; update that link target to a
valid repository page such as "/stargazers" (or the repo root) by replacing the
href in the "⭐ **[Star](.../star)**" link so the call-to-action reliably
navigates to the stargazers page.

---

Duplicate comments:
In `@README.md`:
- Line 279: The Discord widget <img> tag with src
"https://invidget.switchblade.xyz/NBW4zeFcG6" is missing an alt attribute;
update that <img> element to include a meaningful alt text (e.g., alt="Discord
server widget showing member/activity stats") to improve accessibility and avoid
duplication of the earlier missing-alt finding.
- Line 88: The GitHub and F-Droid badge images are missing alt text; update the
two <img> elements (e.g., the one with src
"https://i.ibb.co/q0mdc4Z/get-it-on-github.png" and the other F-Droid badge
image on Line 91) to include meaningful alt attributes like alt="Get it on
GitHub" and alt="Get it on F‑Droid" respectively so the badges are accessible to
screen readers.
- Around line 14-17: The README's platform badge <img> elements lack alt
attributes, which hurts accessibility; update each badge <img> tag (the Android,
Windows, macOS, Linux badge images shown) to include a meaningful alt text like
"Android badge", "Windows badge", "macOS badge", and "Linux badge" respectively
so screen readers can announce them.
- Line 67: The README contains <img> tags (e.g., the banner image tag shown and
the screenshot image cells) with empty alt attributes; update those image
elements to include concise, descriptive alt text that describes the image
content and purpose (for example replace alt="" with alt="Project banner showing
X" or alt="Screenshot of Y feature") for the banner and the screenshots
referenced in the README to satisfy accessibility requirements.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 900608cf-8458-4e97-9045-959a11486d4d

📥 Commits

Reviewing files that changed from the base of the PR and between 1b92692 and 1f74437.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md

GitHub Store is 100% free. No ads. No tracking.

- ⭐ **[Star](https://github.com/OpenHub-Store/GitHub-Store/star)** this repository
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix the Star link path to avoid a broken CTA.

Line 360 links to /star, which is not a standard repository page route. Use /stargazers (or repo root) so the call-to-action reliably works.

Proposed fix
-- ⭐ **[Star](https://github.com/OpenHub-Store/GitHub-Store/star)** this repository
+- ⭐ **[Star](https://github.com/OpenHub-Store/GitHub-Store/stargazers)** this repository
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
-**[Star](https://github.com/OpenHub-Store/GitHub-Store/star)** this repository
-**[Star](https://github.com/OpenHub-Store/GitHub-Store/stargazers)** this repository
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 360, The "⭐ **[Star](.../star)**" markdown link in
README.md points to a nonstandard "/star" route causing a broken CTA; update
that link target to a valid repository page such as "/stargazers" (or the repo
root) by replacing the href in the "⭐ **[Star](.../star)**" link so the
call-to-action reliably navigates to the stargazers page.

Updated badge links and added new sections for features, FAQ, and project support.
@rainxchzed rainxchzed merged commit f9f973c into OpenHub-Store:main Apr 26, 2026
1 check was pending
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants