Skip to content

chore(unraid): sync unraid template with README#417

Merged
zachyale merged 1 commit into
developfrom
feat/unraid-readme-alignment--
Apr 8, 2026
Merged

chore(unraid): sync unraid template with README#417
zachyale merged 1 commit into
developfrom
feat/unraid-readme-alignment--

Conversation

@zachyale

@zachyale zachyale commented Apr 7, 2026

Copy link
Copy Markdown
Member

Description

This PR updates the Unraid template to reflect the current README and runtime defaults.

Linked Issue: Fixes #416

Changes

  • Updated Discord link to the current server invite
  • Added support for Unraid to customize availability of the API docs
  • Changed setup guidance link to docs (grimmory.org/docs/getting-started)
  • Corrected library mount target from /data/media/books to /books

Summary by CodeRabbit

  • New Features

    • Added optional configuration to control public API documentation availability.
  • Configuration Changes

    • Updated Book Library target path for improved organization.
    • Adjusted documentation reference for better setup guidance.
  • Documentation

    • Enhanced configuration overview text for clarity.
    • Updated community support link.

@coderabbitai

coderabbitai Bot commented Apr 7, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

Updated the Unraid template file to align with current project documentation and container structure. Changes include refreshed Discord community link, revised overview text, updated support reference link, adjusted Book Library mount path, and added optional API documentation configuration variable.

Changes

Cohort / File(s) Summary
Unraid Template Configuration
unraid.xml
Updated Discord invite URL; refined overview and description text; changed "Requires" link to Grimmory docs; modified Book Library target path from /data/media/books to /books; added new optional advanced variable API_DOCS_ENABLED (default false) to control API documentation availability.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested labels

chore, enhancement

Poem

🐰 A template refreshed with care and grace,
New paths and links now have their place,
The Discord door swings open wide,
API docs dance with pride and guide,
Hop along, configuration's done!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The PR title follows the conventional commit format with type(scope): description pattern.
Linked Issues check ✅ Passed The PR fully addresses all coding-related objectives from issue #416: Discord link updated, overview text revised, docs link changed, and library path corrected.
Out of Scope Changes check ✅ Passed All changes in the PR are directly related to issue #416 objectives; no out-of-scope modifications were introduced.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check ✅ Passed The PR description clearly outlines all major changes and includes linked issue reference, meeting template requirements.

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

✨ 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 feat/unraid-readme-alignment--
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch feat/unraid-readme-alignment--

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
unraid.xml (1)

38-38: New configuration variable not mentioned in PR objectives.

The addition of API_DOCS_ENABLED is valid and aligns with the backend configuration in application.yaml and the ScalarController. However, this change wasn't mentioned in the PR description or linked issue #416.

Consider:

  1. Updating the PR description to document this addition.
  2. Adding corresponding documentation in grimmory-docs, since the linked repository research found no references to API_DOCS_ENABLED in the docs repo.

,

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

In `@unraid.xml` at line 38, Add a note to the PR description and link issue `#416`
stating that a new config variable API_DOCS_ENABLED was added (it maps to the
backend setting in application.yaml and is consumed by ScalarController) and
create/submit a short documentation entry in the grimmory-docs repo describing
the config key, default value (false), purpose (enable public API docs/OpenAPI
JSON), and where to change it so users know how to enable the feature; reference
API_DOCS_ENABLED, application.yaml, and ScalarController in both the PR
description and the docs entry.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@unraid.xml`:
- Line 38: Add a note to the PR description and link issue `#416` stating that a
new config variable API_DOCS_ENABLED was added (it maps to the backend setting
in application.yaml and is consumed by ScalarController) and create/submit a
short documentation entry in the grimmory-docs repo describing the config key,
default value (false), purpose (enable public API docs/OpenAPI JSON), and where
to change it so users know how to enable the feature; reference
API_DOCS_ENABLED, application.yaml, and ScalarController in both the PR
description and the docs entry.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ff234b43-9acd-4e59-9afc-2851631c99e3

📥 Commits

Reviewing files that changed from the base of the PR and between c71c99d and 2532154.

📒 Files selected for processing (1)
  • unraid.xml
📜 Review details
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: Test Suite / Frontend Tests
  • GitHub Check: Test Suite / Backend Tests
  • GitHub Check: Analyze (java-kotlin)
🧰 Additional context used
🔀 Multi-repo context grimmory-tools/grimmory-docs

Linked repositories findings

grimmory-tools/grimmory-docs [::grimmory-tools/grimmory-docs::]

  • Library mount path: docs/getting-started.md, docs/installation.md and multiple auth docs reference ./books:/books and /books as the canonical library mount (e.g., docs/getting-started.md:30, docs/installation.md:27, docs/authentication/oidc-settings.md:358/435). This matches the PR change from /data/media/books → /books. [::grimmory-tools/grimmory-docs::]

  • Discord invite: the site header and CTA link to the Discord invite https://discord.gg/vNsB8CTebs in src/pages/HomepageHeader.tsx and src/pages/CallToAction.tsx, and docs/getting-started.md lists the same invite. The PR updates the unraid template Discord invite — verify the new invite matches these files. [::grimmory-tools/grimmory-docs::]

  • API docs / OpenAPI flag: no occurrences of API_DOCS_ENABLED, API_DOCS, openapi, or /openapi.json were found in the repo search output. There is no evidence the docs site exposes or documents a public OpenAPI JSON endpoint to be toggled by API_DOCS_ENABLED. (Search for "API_DOCS_ENABLED|API_DOCS|openapi|OpenAPI|/openapi.json|/docs" returned no matches.) [::grimmory-tools/grimmory-docs::]

Notes / impact:

  • The unraid.xml change to use /books aligns with existing docs; no further docs updates appear necessary.
  • Confirm the Discord invite in the PR equals vNsB8CTebs (or update docs/src pages if the invite changed).
  • The new API_DOCS_ENABLED variable appears not to be referenced in this docs repo — if enabling public API docs requires documentation, add docs pages or mention in installation/getting-started as needed. [::grimmory-tools/grimmory-docs::]
🔇 Additional comments (4)
unraid.xml (4)

13-13: LGTM!

Overview text update aligns with PR objectives for branding refresh.


30-30: LGTM!

The setup guidance link now points to the getting-started docs as specified in the PR objectives.


33-33: LGTM!

The mount target path change from /data/media/books to /books aligns with the canonical library mount documented in grimmory-docs (docs/getting-started.md, docs/installation.md, etc.).


11-11: The Discord invite 9YJ7HB4n8T in this PR is consistent with the rest of the grimmory repository (README.md, CONTRIBUTING.md). However, the grimmory-docs repository currently references a different invite (vNsB8CTebs). Both invites are valid. If maintaining a single Discord server across both repositories is intended, the docs repository should be updated separately to align.

@zachyale zachyale merged commit a3c0dca into develop Apr 8, 2026
15 checks passed
@zachyale zachyale deleted the feat/unraid-readme-alignment-- branch April 8, 2026 07:54
zachyale added a commit to zachyale/grimmory that referenced this pull request Apr 17, 2026
zachyale added a commit to zachyale/grimmory that referenced this pull request Apr 17, 2026
dsmouse pushed a commit to dsmouse/grimmory that referenced this pull request May 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Align Unraid template with README

2 participants