diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml index f264564..db48606 100644 --- 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 new file mode 100644 index 0000000..9ac3b33 --- /dev/null +++ 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 index c306efc..c792164 100644 --- 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) diff --git a/sidebars.ts b/sidebars.ts index bc20d12..09349b9 100644 --- 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: '', 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'}, ],