Skip to content

feat: adding suggested maintainers.md and fixing rendering issues in readme.md - #13

Open
reach2saksham wants to merge 1 commit into
AOSSIE-Org:mainfrom
reach2saksham:feat/final-improvements
Open

feat: adding suggested maintainers.md and fixing rendering issues in readme.md#13
reach2saksham wants to merge 1 commit into
AOSSIE-Org:mainfrom
reach2saksham:feat/final-improvements

Conversation

@reach2saksham

@reach2saksham reach2saksham commented Aug 7, 2026

Copy link
Copy Markdown
Member

Small Improvements that I will keep on adding for sometime before merging this PR.

Additional Notes:

AI Usage Disclosure:

We encourage contributors to use AI tools responsibly when creating Pull Requests. While AI can be a valuable aid, it is essential to ensure that your contributions meet the task requirements, build successfully, include relevant tests, and pass all linters. Submissions that do not meet these standards may be closed without warning to maintain the quality and integrity of the project. Please take the time to understand the changes you are proposing and their impact. AI slop is strongly discouraged and may lead to banning and blocking. Do not spam our repos with AI slop.

Check one of the checkboxes below:

  • This PR does not contain AI-generated code at all.
  • This PR contains AI-generated code. I have read the AI Usage Policy and this PR complies with this policy. I have tested the code locally and I am responsible for it.

I have used the following AI models and tools: TODO

Checklist

  • My PR addresses a single issue, fixes a single bug or makes a single improvement.
  • My code follows the project's code style and conventions
  • If applicable, I have made corresponding changes or additions to the documentation
  • If applicable, I have made corresponding changes or additions to tests
  • My changes generate no new warnings or errors
  • I have joined the Discord server and I will share a link to this PR with the project maintainers there
  • I have read the Contribution Guidelines
  • Once I submit my PR, CodeRabbit AI will automatically review it and I will address CodeRabbit's comments.
  • I have filled this PR template completely and carefully, and I understand that my PR may be closed without review otherwise.

Summary by CodeRabbit

  • Documentation
    • Added contribution guidelines with links to the contribution and sign-off documents.
    • Improved README layout, branding, badges, links, and spacing.
  • Bug Fixes
    • Restricted locale pages to supported parameters, preventing invalid locale routes.
  • Chores
    • Updated sitemap domain guidance for production configuration.

@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown

Review Change Stack

Walkthrough

The changes update repository documentation and badges, add contribution links, disable dynamic locale parameters, and correct the sitemap fallback-domain comment.

Changes

Repository documentation

Layer / File(s) Summary
Contribution and project documentation
MAINTAINERS.md, README.md
Adds contribution document links and updates README markup, logos, badges, and social links.
Sitemap domain guidance
src/app/sitemap.ts
Updates the documented production fallback domain.

Locale routing configuration

Layer / File(s) Summary
Static locale parameters
src/app/[locale]/layout.tsx
Exports dynamicParams = false for locale routes.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested labels: Typescript Lang, Documentation

Poem

A rabbit checks the badges bright,
And links the guides in clear daylight.
Locale paths now stay in place,
The sitemap sign shows the proper place.
Hop, hop—clean docs join the race!

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
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.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the two main changes: adding maintainer guidance and fixing README rendering issues.
✨ 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.

@reach2saksham reach2saksham self-assigned this Aug 7, 2026
@reach2saksham reach2saksham added documentation Improvements or additions to documentation enhancement New feature or request labels Aug 7, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

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 current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@MAINTAINERS.md`:
- Line 27: Ensure MAINTAINERS.md ends with exactly one newline character after
the final contribution guidance sentence, resolving the markdownlint MD047
violation without changing the document content.
- Line 27: Resolve the broken contribution-guide reference in MAINTAINERS.md by
either adding the missing CONTRIBUTING.md file or updating the link to the
repository’s existing contribution guide. Ensure the resulting relative link
points to a valid document before submission.

In `@README.md`:
- Around line 8-13: Replace the placeholder branding in the README’s centered
logo and AOSSIE badge blocks: update the logo asset and alt text, badge project
name and label, and linked URL to the actual project values, or remove those
blocks entirely if no branding is available.

In `@src/app/sitemap.ts`:
- Line 10: Update the fallback domain used by the sitemap and its accompanying
comment to the valid production origin https://project.aossie.org, matching the
existing README.md documentation. Ensure all three references use the same
domain consistently when NEXT_PUBLIC_SITE_URL is unset.
🪄 Autofix

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.yml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: d11f53ff-c3f5-4062-bc8a-1ae06ad988a2

📥 Commits

Reviewing files that changed from the base of the PR and between 14b11f7 and 6b2e098.

📒 Files selected for processing (4)
  • MAINTAINERS.md
  • README.md
  • src/app/[locale]/layout.tsx
  • src/app/sitemap.ts

Comment thread MAINTAINERS.md

## 📜 Contribution Guidelines

Please read our [`CONTRIBUTING.md`](CONTRIBUTING.md) and [`DCO.md`](DCO.md) before submitting pull requests. All contributions are welcome! No newline at end of file

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Add the required final newline.

markdownlint-cli2 reports MD047 on Line 27. End MAINTAINERS.md with exactly one newline character.

🧰 Tools
🪛 markdownlint-cli2 (0.23.2)

[warning] 27-27: Files should end with a single newline character

(MD047, single-trailing-newline)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@MAINTAINERS.md` at line 27, Ensure MAINTAINERS.md ends with exactly one
newline character after the final contribution guidance sentence, resolving the
markdownlint MD047 violation without changing the document content.

Source: Linters/SAST tools


📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Fix the CONTRIBUTING.md link before merge.

The repository context indicates that CONTRIBUTING.md is not present. Contributors will reach a dead relative link. Add the file or change the link to the correct contribution guide.

🧰 Tools
🪛 markdownlint-cli2 (0.23.2)

[warning] 27-27: Files should end with a single newline character

(MD047, single-trailing-newline)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@MAINTAINERS.md` at line 27, Resolve the broken contribution-guide reference
in MAINTAINERS.md by either adding the missing CONTRIBUTING.md file or updating
the link to the repository’s existing contribution guide. Ensure the resulting
relative link points to a valid document before submission.

Comment thread README.md
Comment thread src/app/sitemap.ts
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant