Skip to content

feat: Promote Community Apps submission entrypoint#481

Merged
elibosley merged 5 commits into
mainfrom
codex/community-apps-submit-docs
May 14, 2026
Merged

feat: Promote Community Apps submission entrypoint#481
elibosley merged 5 commits into
mainfrom
codex/community-apps-submit-docs

Conversation

@elibosley
Copy link
Copy Markdown
Member

@elibosley elibosley commented May 14, 2026

Summary

Promotes Community Applications to a root-level docs page positioned above Unraid Connect, with redirects from the old nested route and the existing /go/applications/ and manual applications redirects updated to the new /community-applications/ path.

Updates docs home Community Applications resource links to use /community-applications/ so users land on the new docs entrypoint before jumping to external app catalog workflows.

Updates the Community Applications contribution section to make https://ca.unraid.net/submit the canonical submission entrypoint, with a prominent centered CTA button. The detailed submission guidance remains on the CA portal as the single source of truth.

Fixes the Community Applications install instructions to tell users to navigate to the Apps tab instead of the Plugins tab.

Impact

Community Applications is easier to find in the primary docs navigation, existing internal and Go links now point to the new root page, and old nested URLs continue to redirect.

Validation

  • pnpm exec remark docs/community-applications.mdx docs/API/index.mdx docs/API/partials/get-started-pre72.mdx docs/unraid-connect/overview-and-setup.mdx docs/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx docs/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx docs/unraid-os/getting-started/what-is-unraid.mdx docs/unraid-os/system-administration/advanced-tools/command-line-interface.mdx docs/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx docs/unraid-os/system-administration/secure-your-server/tailscale.mdx docs/unraid-os/using-unraid-to/customize-your-experience/plugins.mdx docs/unraid-os/using-unraid-to/run-docker-containers/managing-and-customizing-containers.mdx docs/unraid-os/using-unraid-to/run-docker-containers/overview.mdx --quiet --frail
  • pnpm exec remark docs/docs-home.mdx docs/community-applications.mdx --quiet --frail
  • node scripts/check-case-sensitivity.js
  • pnpm exec prettier --check docusaurus.config.ts
  • rg -n "community-applications\.mdx|unraid-os/using-unraid-to/run-docker-containers/community-applications|l\.onglet|form\.asana" docs i18n docusaurus.config.ts static || true

Full build intentionally not run per repo guidance.

Summary by CodeRabbit

Release Notes

  • Documentation
    • Consolidated Community Applications documentation under a unified URL path for easier access across the docs site.
    • Updated navigation instructions to reference the Apps tab instead of the Plugins tab.
    • Streamlined the application submission workflow with a new submission portal link.
    • Updated internal documentation links to point to the consolidated Community Applications page.

Review Change Stack

- Purpose: document the Community Applications repository submission process in the docs site.

- Before: the Community Applications page only had a brief contribution section and pointed maintainers to the old Asana submission form.

- Problem: app maintainers lacked in-repo guidance for repository structure, XML metadata, supported fields, and the current submission portal.

- Change: add a dedicated submission docs section with overview, repository XML, ca_profile.xml, field reference, and builder guide pages.

- Implementation: link the existing Community Applications page to the new section, move the submission URL to ca.unraid.net/submit, update translated snapshot links, and adjust sidebar ordering.
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 14, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: dcb36975-207a-4c0d-ae59-d7f7bfedae7b

📥 Commits

Reviewing files that changed from the base of the PR and between 30eeb5c and bda1884.

📒 Files selected for processing (76)
  • docs/API/index.mdx
  • docs/API/partials/get-started-pre72.mdx
  • docs/community-applications.mdx
  • docs/docs-home.mdx
  • docs/unraid-connect/overview-and-setup.mdx
  • docs/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx
  • docs/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx
  • docs/unraid-os/getting-started/what-is-unraid.mdx
  • docs/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • docs/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx
  • docs/unraid-os/system-administration/secure-your-server/tailscale.mdx
  • docs/unraid-os/using-unraid-to/customize-your-experience/plugins.mdx
  • docs/unraid-os/using-unraid-to/run-docker-containers/managing-and-customizing-containers.mdx
  • docs/unraid-os/using-unraid-to/run-docker-containers/overview.mdx
  • docusaurus.config.ts
  • i18n/de/docusaurus-plugin-content-docs/current/community-applications.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/docs-home.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-connect/overview-and-setup.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/getting-started/what-is-unraid.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/tailscale.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/customize-your-experience/plugins.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/managing-and-customizing-containers.mdx
  • i18n/de/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/overview.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/community-applications.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/docs-home.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-connect/overview-and-setup.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/getting-started/what-is-unraid.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/tailscale.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/customize-your-experience/plugins.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/managing-and-customizing-containers.mdx
  • i18n/es/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/overview.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/community-applications.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/docs-home.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-connect/overview-and-setup.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/getting-started/what-is-unraid.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/tailscale.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/customize-your-experience/plugins.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/managing-and-customizing-containers.mdx
  • i18n/fr/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/overview.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/API/partials/get-started-pre72.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/community-applications.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/docs-home.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-connect/overview-and-setup.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/getting-started/what-is-unraid.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/tailscale.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/customize-your-experience/plugins.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/managing-and-customizing-containers.mdx
  • i18n/ja/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/overview.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/community-applications.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/docs-home.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-connect/overview-and-setup.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/getting-started/explore-the-user-interface/tour-the-web-gui.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/getting-started/what-is-unraid.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/system-administration/advanced-tools/command-line-interface.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/security-fundamentals.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/system-administration/secure-your-server/tailscale.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/customize-your-experience/plugins.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/managing-and-customizing-containers.mdx
  • i18n/zh/docusaurus-plugin-content-docs/current/unraid-os/using-unraid-to/run-docker-containers/overview.mdx

Disabled knowledge base sources:

  • Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.


📝 Walkthrough

Walkthrough

This PR consolidates Unraid's Community Applications documentation by establishing a unified /community-applications/ hub page, updating all internal documentation links across English and eight language versions to reference this page, and configuring Docusaurus redirects to maintain backward compatibility with legacy URL paths.

Changes

Community Applications Documentation Hub Consolidation

Layer / File(s) Summary
Community Applications page restructure
docs/community-applications.mdx, i18n/de/docusaurus-plugin-content-docs/current/community-applications.mdx, i18n/es/docusaurus-plugin-content-docs/current/community-applications.mdx, i18n/fr/docusaurus-plugin-content-docs/current/community-applications.mdx, i18n/ja/docusaurus-plugin-content-docs/current/community-applications.mdx, i18n/zh/docusaurus-plugin-content-docs/current/community-applications.mdx
Community Applications pages across all languages are updated with sidebar_position: 1.5, new MDX partial import paths, restructured contribution workflow with simplified portal-based submission, installation instructions changed to reference Apps tab instead of Plugins tab, and consolidated submission URL (ca.unraid.net/submit).
Docusaurus redirect configuration
docusaurus.config.ts
Redirect mappings updated so legacy paths (/unraid-os/manual/applications/ and /go/applications/) route to the consolidated /community-applications/ page.
Unraid Connect setup links
docs/unraid-connect/overview-and-setup.mdx, i18n/*/docusaurus-plugin-content-docs/current/unraid-connect/overview-and-setup.mdx
Installation prerequisite links to Community Applications updated from relative paths to absolute /community-applications/ path across English and language versions.
English documentation link standardization
docs/docs-home.mdx, docs/unraid-os/getting-started/*/tour-the-web-gui.mdx, docs/unraid-os/getting-started/set-up-unraid/customize-unraid-settings.mdx, docs/unraid-os/getting-started/what-is-unraid.mdx, docs/unraid-os/system-administration/advanced-tools/command-line-interface.mdx, docs/unraid-os/system-administration/secure-your-server/*, docs/unraid-os/using-unraid-to/*/plugins.mdx, docs/unraid-os/using-unraid-to/run-docker-containers/*
All Community Applications references standardized to /community-applications/ across homepage, getting-started guides, system administration pages, and Docker container documentation.
Multilingual documentation link updates
i18n/de/..., i18n/es/..., i18n/fr/..., i18n/ja/..., i18n/zh/docusaurus-plugin-content-docs/current/
Corresponding link standardization applied across German, Spanish, French, Japanese, and Chinese documentation versions in all affected subsections and guides.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hop along the consolidated path,
Where Community Apps now rest at last,
One true home, no more scattered routes,
Documentation blooms in trusty boots,
Redirects guide the old-path friends,
A tidy garden without loose ends! 🌱

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/community-apps-submit-docs

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint skipped: no ESLint configuration detected in root package.json. To enable, add eslint to devDependencies.


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

@elibosley elibosley changed the title [codex] Add Community Apps submission docs feat: Add Community Apps submission docs May 14, 2026
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 14, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
unraid-docs bda1884 Commit Preview URL

Branch Preview URL
May 14 2026, 04:06 PM

- Purpose: make ca.unraid.net/submit the single source of truth for Community Applications submission guidance.

- Before: the PR duplicated portal-owned repository XML, ca_profile.xml, field reference, and builder guidance in this docs site.

- Problem: duplicating submission details makes it easier for the docs site and portal to drift, and gives users more than one place to check.

- Change: remove the local submission guide pages and simplify the Community Applications contribution section to point at the submission portal and help page.

- Implementation: delete the local submission docs category, restore the container-management sidebar position, and keep translated snapshot links pointed at ca.unraid.net/submit from the previous commit.
@elibosley elibosley changed the title feat: Add Community Apps submission docs [codex] Point Community Apps submissions to portal May 14, 2026
elibosley added 2 commits May 14, 2026 11:26
- Purpose: make the Community Apps submission portal link easier to find on the docs page.

- Before: the portal appeared only as inline text and a numbered-list link.

- Problem: maintainers could miss the canonical submission destination while scanning the page.

- Change: add a large centered primary CTA button linking to ca.unraid.net/submit.

- Implementation: use Docusaurus button classes with modest inline sizing inside the existing Community Applications MDX page.
- Purpose: promote Community Applications to a top-level docs page above Unraid Connect.

- Before: the page lived under Run Docker containers, so it was harder to find and all internal docs linked to the nested path.

- Problem: Community Applications is a broad entry point for plugins and apps, not only Docker container guidance.

- Change: move the Community Applications MDX file and localized counterparts to the docs root with sidebar position 1.5.

- Implementation: update partial imports, internal links, localized link references, and redirects from the old nested route; fix the install section to direct users to the Apps tab.
@elibosley elibosley changed the title [codex] Point Community Apps submissions to portal [codex] Promote Community Apps submission entrypoint May 14, 2026
- Purpose: route docs home Community Applications links through the new root docs page.

- Before: the docs home resource links bypassed the docs entrypoint and opened the external app catalog directly.

- Problem: after promoting Community Applications to a root docs page, discovery links should consistently land on the new guidance page.

- Change: update source and translated docs home resource links to /community-applications/.

- Implementation: keep app-specific catalog links elsewhere unchanged and leave /go/applications/ redirected to the new docs page.
@elibosley elibosley marked this pull request as ready for review May 14, 2026 16:13
@elibosley elibosley changed the title [codex] Promote Community Apps submission entrypoint feat: Promote Community Apps submission entrypoint May 14, 2026
@elibosley elibosley merged commit ad802ee into main May 14, 2026
4 of 5 checks passed
@elibosley elibosley deleted the codex/community-apps-submit-docs branch May 14, 2026 16:13
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.

1 participant