Skip to content

docs: update README social links #1197

Open
VasuS609 wants to merge 1 commit intoAOSSIE-Org:mainfrom
VasuS609:readme-pr-clean
Open

docs: update README social links #1197
VasuS609 wants to merge 1 commit intoAOSSIE-Org:mainfrom
VasuS609:readme-pr-clean

Conversation

@VasuS609
Copy link
Contributor

@VasuS609 VasuS609 commented Feb 26, 2026

fixes: #1190

Screenshot 2026-02-26 161927

PR Description

  • This PR improves the project README to make it more clear, complete, and welcoming for new contributors and users.

  • I updated the top section with AOSSIE branding/social badges and cleaned up the README structure/content so key project information is easier to find.


What changed

  • Added/updated organization social links and badges (Email, Telegram, X, Discord, Medium, LinkedIn, YouTube).

  • Refined README content/formatting for better readability and consistency.


Documentation-only change.
No application code, logic, or behavior changes.

Let me know if any changes are needed.

Summary by CodeRabbit

  • Documentation
    • Updated README with improved branding, visual layout, and contact information.
    • Added Features section highlighting key product capabilities.
    • Introduced Tech Stack table with comprehensive technology overview.
    • Added Architecture section explaining system design.
    • Included Repositories information for easier project navigation.
    • Updated footer with copyright attribution.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 26, 2026

Walkthrough

The README.md has been comprehensively restructured with new branding elements, social links (including YouTube), a features section with project capabilities, an expanded tech stack table, detailed architecture information, repository structure, and updated footer attribution.

Changes

Cohort / File(s) Summary
Documentation
README.md
Restructured README with new header layout, branding, social badges (Discord and YouTube), Features section listing project capabilities, expanded Tech Stack table covering frontend/backend technologies, Architecture section detailing component roles, Repositories subsection, and updated 2026 copyright notice.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

Documentation

Poem

🐰 A README renewed with flair so bright,
Features and tech stacks now shine just right,
YouTube links hop alongside Discord's cheer,
Architecture blooming crystal clear,
Our little warren's story, told with care! 🏗️✨

🚥 Pre-merge checks | ✅ 1 | ❌ 3

❌ Failed checks (3 warnings)

Check name Status Explanation Resolution
Title check ⚠️ Warning The title states 'update README social links' but the changes include extensive README restructuring far beyond social links, including new Features, Tech Stack, Architecture sections. Update title to reflect comprehensive README restructuring, such as 'docs: restructure README with branding, features, tech stack, and architecture details'.
Linked Issues check ⚠️ Warning Issue #1190 requires adding only YouTube badge to 'Want to Contribute?' section; PR instead completely restructures README with new layout, features, tech stack, and architecture sections. Clarify scope: either limit changes to YouTube badge addition per issue #1190, or update the issue to document the comprehensive README restructuring as a separate objective.
Out of Scope Changes check ⚠️ Warning Extensive out-of-scope changes detected: new Features section, Tech Stack table, Architecture section, Repositories subsection, and footer updates far exceed the YouTube badge addition requirement in issue #1190. Document or split out-of-scope changes as a separate enhancement PR, or update linked issue #1190 to explicitly include comprehensive README restructuring objectives.
✅ Passed checks (1 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.


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
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: 2

🧹 Nitpick comments (1)
README.md (1)

96-112: Well-structured architecture documentation.

The architecture section clearly explains the roles of each component.

Minor optional refinement: Line 106 refers to "YOLO" generically, while line 83 in the Tech Stack table specifies "YOLOv11". Consider using "YOLOv11" consistently for precision.

📝 Optional consistency improvement
 ### Backend (Python)
 - **FastAPI**: Serves as the high-performance API framework.
 - **SQLite**: Database for storing metadata and embeddings.
-- **YOLO**: Used for precise object detection.
+- **YOLOv11**: Used for precise object detection.
 - **FaceNet**: Generates face embeddings for recognition.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 96 - 112, Update the architecture doc to use the
specific model name "YOLOv11" instead of the generic "YOLO" for consistency with
the Tech Stack table; modify the Backend (Python) section where "YOLO" appears
(in the list under "## 🏗️ Architecture" and the bullet labeled "YOLO") so it
reads "YOLOv11" and keep the rest of the description unchanged.
🤖 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 27-28: The README contains incorrect brand links: replace the
Telegram URL 'https://t.me/StabilityNexus' and the Medium URL
'news.stability.nexus/' with the official AOSSIE channels (or remove them if
they are not official), and then add or update these entries in the social
section of mkdocs.yml to match the other identifiers (email
aossie.oss@gmail.com, X `@aossie_org`, Discord AOSSIE, LinkedIn /company/aossie/,
YouTube `@AOSSIE-Org`); locate the Telegram link in README.md and the social
config in mkdocs.yml and either swap the URLs to the correct AOSSIE
Telegram/Medium endpoints or delete the entries if they are not official.
- Around line 39-40: Replace the current Medium badge link anchor (<a
href="https://news.stability.nexus/"> with its image) so it either points to
AOSSIE's official blog (https://aossie.github.io/) or add an explicit clarifying
note next to the badge that it links to a partner/third‑party Stability Nexus
publication; update the href URL and/or the surrounding text/alt text
accordingly and ensure the badge still renders (the <a> anchor and the <img> alt
text are the symbols to update).

---

Nitpick comments:
In `@README.md`:
- Around line 96-112: Update the architecture doc to use the specific model name
"YOLOv11" instead of the generic "YOLO" for consistency with the Tech Stack
table; modify the Backend (Python) section where "YOLO" appears (in the list
under "## 🏗️ Architecture" and the bullet labeled "YOLO") so it reads "YOLOv11"
and keep the rest of the description unchanged.

ℹ️ Review info

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b270a35 and 0901d28.

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

Comment on lines +27 to +28
<a href="https://t.me/StabilityNexus">
<img src="https://img.shields.io/badge/Telegram-black?style=flat&logo=telegram&logoColor=white&logoSize=auto&color=24A1DE" alt="Telegram Badge"/></a>
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Search for Telegram references and context in the README
rg -i "telegram|t\.me|stability" --type md -C 3

Repository: AOSSIE-Org/PictoPy

Length of output: 2007


🏁 Script executed:

#!/bin/bash
# Search for StabilityNexus or Stability references to understand context
rg -i "stability" --type-list | head -20
echo "---"
# Search all files for StabilityNexus
rg "StabilityNexus" -C 2
echo "---"
# Search for any configuration or metadata about social links
rg -i "social|channel|telegram" --type md --type json --type yaml

Repository: AOSSIE-Org/PictoPy

Length of output: 3763


🏁 Script executed:

#!/bin/bash
# Check mkdocs.yml for social configuration
cat mkdocs.yml | grep -A 10 "social"
echo "---"
# Search for any documentation about project social channels
fd "README" -t f | head -5 | xargs cat | grep -i "social\|channel\|contact" -A 2 -B 2 || echo "No additional docs found"

Repository: AOSSIE-Org/PictoPy

Length of output: 807


🏁 Script executed:

#!/bin/bash
# Check if there are any GitHub issues or discussions mentioning StabilityNexus
git log --all --oneline --grep="StabilityNexus\|Stability" 2>/dev/null | head -10 || echo "No git history found for StabilityNexus"
echo "---"
# Check for any configuration files that might list official channels
fd "\.md$\|\.json$\|\.yaml$\|\.yml$" | xargs grep -l "official\|channel\|social" 2>/dev/null | head -5

Repository: AOSSIE-Org/PictoPy

Length of output: 65


Verify and correct the Telegram and Medium links for brand consistency.

The Telegram link points to t.me/StabilityNexus and the Medium link points to news.stability.nexus/, both using "Stability" branding instead of "AOSSIE". This is inconsistent with all other social links (email: aossie.oss@gmail.com, X: @aossie_org, Discord: AOSSIE, LinkedIn: /company/aossie/, YouTube: @AOSSIE-Org) and neither link appears in the official social section of mkdocs.yml. Confirm whether these channels are official AOSSIE channels or if they should be corrected/removed.

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

In `@README.md` around lines 27 - 28, The README contains incorrect brand links:
replace the Telegram URL 'https://t.me/StabilityNexus' and the Medium URL
'news.stability.nexus/' with the official AOSSIE channels (or remove them if
they are not official), and then add or update these entries in the social
section of mkdocs.yml to match the other identifiers (email
aossie.oss@gmail.com, X `@aossie_org`, Discord AOSSIE, LinkedIn /company/aossie/,
YouTube `@AOSSIE-Org`); locate the Telegram link in README.md and the social
config in mkdocs.yml and either swap the URLs to the correct AOSSIE
Telegram/Medium endpoints or delete the entries if they are not official.

Comment on lines +39 to +40
<a href="https://news.stability.nexus/">
<img src="https://img.shields.io/badge/Medium-black?style=flat&logo=medium&logoColor=black&logoSize=auto&color=white" alt="Medium Badge"></a>
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Search for Medium links and AOSSIE branding in the codebase
rg -i "medium|stability\.nexus|aossie" --type md -C 2

Repository: AOSSIE-Org/PictoPy

Length of output: 7226


🏁 Script executed:

#!/bin/bash
# Check if there are any comments or documentation about the Medium link
cd README.md 2>/dev/null || true
cat README.md | grep -A 5 -B 5 "news.stability.nexus"

# Also check for any other Medium references or docs
rg "medium" -i --type md

Repository: AOSSIE-Org/PictoPy

Length of output: 1468


🌐 Web query:

AOSSIE organization official Medium profile

💡 Result:

I couldn’t find any official AOSSIE organization account/publication on Medium (i.e., a Medium profile clearly owned and linked by AOSSIE). Searches only turn up individual authors’ posts mentioning AOSSIE, not an org-owned Medium profile. [1], [2]

If you’re looking for AOSSIE’s official long-form posts instead, their official blog is hosted outside Medium:

Sources:
[1] https://medium.com/%40sarthakd/the-guide-to-aossie-slagora-58f5ec8d5410
[2] https://medium.com/%40kukkadapusushma12/sushma-kukkadapu-google-summer-of-code-2018-aossie-e6134a055046
[3] https://aossie.github.io/2016/02/02/aossie-announcement.html
[4] https://github.com/AOSSIE-Org/AOSSIE-Blogs


🌐 Web query:

news.stability.nexus AOSSIE Medium

💡 Result:

  • news.stability.nexus is a Medium-hosted publication titled “Articles” (shows Medium sign-in, “Follow”, subscriber prompts, etc.), i.e., it’s essentially a Medium publication under the Stability Nexus brand. [1]
  • Some Medium posts (e.g., in the Djed Alliance Medium publication) explicitly state they were “Originally published at https://news.stability.nexus”, indicating cross-posting/syndication between Medium and news.stability.nexus. [2]
  • AOSSIE is connected via Stability Nexus activities: Stability Nexus documentation lists AOSSIE as a sponsoring organisation for the “Unstoppable Hackathon” alongside Stability Nexus (and others). [3]

Sources: [1] [2] [3]


Update Medium link to reflect official AOSSIE presence or clarify intent.

The link https://news.stability.nexus/ points to a Stability Nexus publication, not an official AOSSIE Medium account. AOSSIE has no official Medium profile; the organization's official blog is published at https://aossie.github.io/. Either update the link to point to AOSSIE's official blog (https://aossie.github.io/) to maintain consistent branding, or add a comment clarifying that this link directs to partner organization content.

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

In `@README.md` around lines 39 - 40, Replace the current Medium badge link anchor
(<a href="https://news.stability.nexus/"> with its image) so it either points to
AOSSIE's official blog (https://aossie.github.io/) or add an explicit clarifying
note next to the badge that it links to a partner/third‑party Stability Nexus
publication; update the href URL and/or the surrounding text/alt text
accordingly and ensure the badge still renders (the <a> anchor and the <img> alt
text are the symbols to update).

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.

Feat: chore: Add YouTube social link to README.md

1 participant