Skip to content

Update README#53

Merged
lucperkins merged 2 commits intomainfrom
update-readme
Mar 9, 2026
Merged

Update README#53
lucperkins merged 2 commits intomainfrom
update-readme

Conversation

@lucperkins
Copy link
Member

@lucperkins lucperkins commented Mar 6, 2026

This PR updates the README to better reflect the current reality of the feature.

Summary by CodeRabbit

  • Documentation
    • Clarified Flake schema behavior and default reference to Determinate Nix (det-nix)
    • Expanded supported flake output types list (apps, bundles, checks, darwinConfigurations, darwinModules, devShells, formatter, homeConfigurations, homeModules, hydraJobs, legacyPackages, nixosConfigurations, nixosModules, ociImages, overlays, packages, plus schemas and templates)
    • Removed experimental flake schemas section
    • Updated dev/test/formatting instructions, switched example blocks to shell, and refreshed external links and anchors

@coderabbitai
Copy link

coderabbitai bot commented Mar 6, 2026

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: efb82ed4-2979-428a-aadf-742ef2002d08

📥 Commits

Reviewing files that changed from the base of the PR and between 6d79d92 and 058d0c3.

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

📝 Walkthrough

Walkthrough

The README replaces an advisory about unsupported Flake schemas with a reference to Determinate Nix, expands the list of supported flake output types, removes the experimental-flake-schemas section, updates development/testing instruction formatting, and adjusts cross-references and external links.

Changes

Cohort / File(s) Summary
README Documentation Updates
README.md
Replaces Flake schema advisory with a Determinate Nix reference; expands supported flake output types list (adds apps, bundles, checks, darwinConfigurations, darwinModules, devShells, formatter, homeConfigurations, homeModules, hydraJobs, legacyPackages, nixosConfigurations, nixosModules, ociImages, overlays, packages, retains schemas and templates); removes experimental/experimental-flake-schemas section; converts dev/test code blocks to shell format; updates external links and anchors from blog/eelco to det-nix.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰✨ Docs were stale, now shiny and bright,
Flake outputs listed, everything right,
Determinate Nix takes the stage with pride,
Old schemas fade as new paths guide,
Our README hops to a cleaner light! 📚

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Update README' is vague and generic; it does not specifically convey what changes were made to the README or the primary purpose of the update. Use a more descriptive title that specifies the main change, such as 'Update README with expanded flake output types and Determinate Nix reference' or 'Improve README documentation of supported flake schemas'.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ 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
  • Commit unit tests in branch update-readme

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

@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.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
README.md (1)

6-25: ⚠️ Potential issue | 🟠 Major

Clarify the documentation about test coverage for advertised output types.

The README lists 18 "currently covered output types," but only 5 have test directories (checks, legacyPackages, packages, schemas, and nixosConfigurations), while 13 others lack test coverage. The term "covered" may mislead users into assuming all types are tested and verified.

Consider either:

  1. Adding test coverage for the remaining 13 types before advertising them as "covered"
  2. Clarifying the language to distinguish between "schema definitions available" vs "tested and verified"
  3. Adding a note about which types have comprehensive test coverage
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 6 - 25, The README currently states "The currently
covered output types:" listing items like apps, bundlers, checks,
darwinConfigurations, devShells, formatter, homeConfigurations, hydraJobs,
legacyPackages, nixosConfigurations, nixosModules, ociImages, overlays,
packages, schemas, templates, etc., which is misleading because only checks,
legacyPackages, packages, schemas and nixosConfigurations have test directories;
update the wording to clarify the distinction (e.g., "Output types with schema
definitions" vs "Output types with test coverage"), and add a short note or
bullet that explicitly lists the types with comprehensive tests (checks,
legacyPackages, packages, schemas, nixosConfigurations) or mark each item with a
test/no-test indicator so readers can tell which outputs are actually tested.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@README.md`:
- Around line 6-25: The README currently states "The currently covered output
types:" listing items like apps, bundlers, checks, darwinConfigurations,
devShells, formatter, homeConfigurations, hydraJobs, legacyPackages,
nixosConfigurations, nixosModules, ociImages, overlays, packages, schemas,
templates, etc., which is misleading because only checks, legacyPackages,
packages, schemas and nixosConfigurations have test directories; update the
wording to clarify the distinction (e.g., "Output types with schema definitions"
vs "Output types with test coverage"), and add a short note or bullet that
explicitly lists the types with comprehensive tests (checks, legacyPackages,
packages, schemas, nixosConfigurations) or mark each item with a test/no-test
indicator so readers can tell which outputs are actually tested.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 453776b6-2a06-45d9-aaf6-13f989708c9a

📥 Commits

Reviewing files that changed from the base of the PR and between da9a9ae and 6d79d92.

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

@lucperkins lucperkins enabled auto-merge March 9, 2026 16:00
@lucperkins lucperkins merged commit 834aaad into main Mar 9, 2026
1 of 2 checks passed
@lucperkins lucperkins deleted the update-readme branch March 9, 2026 16:05
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.

2 participants