tuna-os · hanthor-hive-agent · Jun 27, 2026 · Jun 28, 2026
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
@@ -21,9 +21,9 @@ jobs:
     name: Markdown Lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@11bd71901abe5b8200bef0e37dffb14cc0ad4d7e # v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
-      - uses: actions/setup-node@cd93095a6e160be2cc06e0158b140f5f8aa19670 # v4
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
         with:
           node-version: '20'
 
@@ -42,9 +42,9 @@ jobs:
     name: Node.js Syntax Check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@11bd71901abe5b8200bef0e37dffb14cc0ad4d7e # v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
-      - uses: actions/setup-node@cd93095a6e160be2cc06e0158b140f5f8aa19670 # v4
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
         with:
           node-version: '20'
 
@@ -71,7 +71,7 @@ jobs:
     name: Internal Link Check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@11bd71901abe5b8200bef0e37dffb14cc0ad4d7e # v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
       - name: Check for broken internal references
         run: |

diff --git a/docs/community.md b/docs/community.md
@@ -0,0 +1,63 @@
+---
+sidebar_position: 1
+sidebar_label: "Community"
+---
+
+# 🌐 Community
+
+Welcome to the TunaOS community! Whether you're a user, contributor, or just curious, here's how to get involved.
+
+## 🗣️ Chat & Discussion
+
+| Platform | Purpose | Link |
+|---|---|---|
+| **Matrix** | Primary chat — ask questions, share setups | [#tunaos:reilly.asia](https://matrix.to/#/%23tunaos:reilly.asia) |
+| **GitHub Discussions** | Ideas, Q&A, feature requests | [Start a discussion](https://github.com/tuna-os/tunaOS/discussions) |
+| **GitHub Issues** | Bug reports, feature tracking | [Open an issue](https://github.com/tuna-os/tunaOS/issues) |
+| **Universal Blue Discord** | Larger bootc/atomic desktop community | [Join Discord](https://discord.gg/WEu6BdFEtp) |
+| **AlmaLinux Atomic SIG** | Enterprise Linux bootc discussions | [#sigatomic](https://chat.almalinux.org/almalinux/channels/sigatomic) |
+
+## 🤝 How to Contribute
+
+See the full [Contributor Guide](https://github.com/tuna-os/tunaOS/blob/main/CONTRIBUTING.md) for setup instructions and PR workflow.
+
+| Level | What you do | How to start |
+|---|---|---|
+| **Tester** | Run images, report bugs | Install any variant, open issues |
+| **Contributor** | Fix bugs, improve docs | Look for `good-first-issue` labels, open PRs |
+| **Maintainer** | Own a desktop flavor or variant | Build regularly, review PRs, earn trust |
+
+All contributors must follow our [Code of Conduct](https://github.com/tuna-os/tunaOS/blob/main/CODE_OF_CONDUCT.md).
+
+## 📋 Adoption
+
+If your organization uses TunaOS, we'd love to know!
+
+- Add your org to **[ADOPTERS.md](https://github.com/tuna-os/tunaOS/blob/main/ADOPTERS.md)** — just open a PR
+- Share your setup in [GitHub Discussions](https://github.com/tuna-os/tunaOS/discussions)
+- Write a case study or blog post (we'll help promote it!)
+
+## 📚 Project Resources
+
+| Resource | Description |
+|---|---|
+| [Roadmap](https://github.com/tuna-os/tunaOS/blob/main/ROADMAP.md) | Project direction and feature status |
+| [COMMUNITY.md](https://github.com/tuna-os/tunaOS/blob/main/COMMUNITY.md) | Contribution ladder and governance |
+| [MAINTAINERS.md](https://github.com/tuna-os/tunaOS/blob/main/MAINTAINERS.md) | Maintainer playbook |
+| [Migration Guide](https://github.com/tuna-os/tunaOS/blob/main/MIGRATION.md) | Switch from Fedora Atomic / other distros |
+| [Security Policy](https://github.com/tuna-os/tunaOS/blob/main/SECURITY.md) | Vulnerability reporting |
+
+## 🐠 Related Communities
+
+TunaOS is inspired by and builds upon these projects and communities:
+
+- [Project Bluefin](https://projectbluefin.io) — upstream bootc desktop
+- [Universal Blue](https://universal-blue.org/) — bootc image ecosystem
+- [AlmaLinux OS](https://almalinux.org) — Enterprise Linux foundation
+- [Fedora Project](https://fedoraproject.org) — upstream for Bonito and kernel work
+- [CentOS](https://centos.org) — upstream for Skipjack variant
+- [Bootc](https://github.com/bootc-dev/bootc) — container-native OS technology
+
+---
+
+*Join us! Every contribution, no matter how small, helps build better Enterprise Linux desktops.*
diff --git a/docs/tunaos/index.md b/docs/tunaos/index.md
@@ -21,6 +21,7 @@ Prefer a visual tour? See the **[TunaOS overview →](/tunaos)** landing page.
 [![License](https://img.shields.io/github/license/tuna-os/tunaOS?style=for-the-badge)](https://github.com/tuna-os/tunaOS/blob/main/LICENSE)
 [![GitHub Stars](https://img.shields.io/github/stars/tuna-os/tunaOS?style=for-the-badge)](https://github.com/tuna-os/tunaOS/stargazers)
 [![Issues](https://img.shields.io/github/issues/tuna-os/tunaOS?style=for-the-badge)](https://github.com/tuna-os/tunaOS/issues)
+[![Adopters](https://img.shields.io/badge/adopters-0_entries-2ea44f?style=for-the-badge)](https://github.com/tuna-os/tunaOS/blob/main/ADOPTERS.md)
 
 </div>
 

diff --git a/sidebars.ts b/sidebars.ts
@@ -33,6 +33,7 @@ const sidebars: SidebarsConfig = {
     {type: 'category', label: '📽️ Decks', link: {type: 'doc', id: 'decks/index'}, items: []},
     {type: 'category', label: 'bluefin-cli', link: {type: 'doc', id: 'bluefin-cli/index'}, items: ['bluefin-cli/ROADMAP']},
     {type: 'html', value: '<div class="sidebar-section-label">Community</div>', defaultStyle: true},
+    'community',
     {type: 'doc', id: 'hawaii/index', label: 'Zirconium Hawaii', className: 'sidebar-external'},
     {type: 'doc', id: 'dakota/index', label: 'Dakota (Bluefin)', className: 'sidebar-external'},
   ],