Skip to content

docs: prepare 0.0.37 release docs#3215

Merged
jyaunches merged 2 commits into
mainfrom
docs/release-prep-0.0.37
May 8, 2026
Merged

docs: prepare 0.0.37 release docs#3215
jyaunches merged 2 commits into
mainfrom
docs/release-prep-0.0.37

Conversation

@miyoungc
Copy link
Copy Markdown
Contributor

@miyoungc miyoungc commented May 7, 2026

Summary

  • Bump the docs release metadata to 0.0.37.
  • Document release-prep updates for messaging policy presets, sandbox runtime utilities, and the GPU CDI troubleshooting path.
  • Refresh generated nemoclaw-user-* skills from the updated docs.

Source summary

Test plan

  • python3 scripts/docs-to-skills.py docs/ .agents/skills/ --prefix nemoclaw-user
  • make docs
  • npm run build:cli
  • npm run typecheck:cli
  • Commit and pre-push hooks: markdownlint, docs-to-skills verification, gitleaks, commitlint, CLI typecheck

Skipped

Made with Cursor

Summary by CodeRabbit

  • Documentation
    • Clarified which utilities remain in the sandbox runtime for lightweight inspection and cleanup
    • Noted that messaging endpoints (Discord, Slack, Telegram) are not in the baseline policy and that channel presets are applied during onboarding
    • Added GPU passthrough troubleshooting for gateway startup
    • Updated release/version bump and release-prep workflow guidance, including Discord preset description updates

Update release metadata and refresh generated user skills for the release-prep documentation pass.

Co-authored-by: Cursor <cursoragent@cursor.com>
@miyoungc miyoungc added documentation Improvements or additions to documentation v0.0.37 Release target labels May 7, 2026
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 7, 2026

Review Change Stack
No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 4cfbdc8c-80de-4356-abd2-bcab63db5146

📥 Commits

Reviewing files that changed from the base of the PR and between 5098302 and d530a34.

📒 Files selected for processing (1)
  • .agents/skills/nemoclaw-contributor-update-docs/SKILL.md

📝 Walkthrough

Walkthrough

This PR updates NemoClaw documentation for release 0.0.37, clarifying sandbox runtime utilities retained for operational tasks, network policy baseline exclusions for messaging endpoints, automatic policy preset selection during messaging channel onboarding, Discord preset scope, GPU passthrough troubleshooting for DGX Spark, and corresponding version increments.

Changes

NemoClaw 0.0.37 Documentation & Version Release

Layer / File(s) Summary
Sandbox Runtime Utilities
.agents/skills/nemoclaw-user-deploy-remote/references/sandbox-hardening.md, docs/deployment/sandbox-hardening.md
Runtime image retains vi, jq, dos2unix for lightweight inspection and cleanup despite removing build toolchains and network probes. Durable changes require rebuild from source tree.
Network Policy Baseline & Messaging Endpoints
.agents/skills/nemoclaw-user-reference/references/network-policies.md, docs/reference/network-policies.md
Telegram, Discord, and Slack messaging endpoints are excluded from baseline policy. Users must enable channels during onboarding or apply corresponding messaging preset.
Messaging Channels Onboarding & Preset Selection
.agents/skills/nemoclaw-user-manage-sandboxes/references/messaging-channels.md, docs/manage-sandboxes/messaging-channels.md
NemoClaw automatically selects matching network policy preset during policy setup when messaging channel is enabled during onboarding.
Discord Preset & Policy Editing Guidance
.agents/skills/nemoclaw-user-manage-policy/SKILL.md, docs/network-policy/customize-network-policy.md
Discord preset now describes API, gateway, and CDN access (broader than webhook-only). Static policy edits must be performed on host outside sandbox.
Troubleshooting & Version Bump
.agents/skills/nemoclaw-user-reference/references/troubleshooting.md, docs/project.json, docs/versions1.json
Added DGX Spark troubleshooting for GPU passthrough failures caused by missing NVIDIA CDI specs, with remediation steps. Version bumped from 0.0.36 to 0.0.37 in project metadata and documentation index.
Contributor Release-Prep Workflow
.agents/skills/nemoclaw-contributor-update-docs/SKILL.md
Expanded release-prep steps: bump docs versions, derive vX.Y.Z label, refresh generated user skills from docs/, and require applying documentation + vX.Y.Z labels when creating the PR.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Docs dancing in the spring,
Utilities and policies aligned,
Messaging presets that flow,
GPU troubleshoot's a gift bestowed,
Version 0.0.37 takes flight!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The pull request title clearly and accurately summarizes the main change: bumping documentation and release metadata from 0.0.36 to 0.0.37, with supporting content updates for messaging presets, sandbox utilities, and GPU troubleshooting.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/release-prep-0.0.37

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

Copy link
Copy Markdown
Contributor

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

🧹 Nitpick comments (1)
docs/network-policy/customize-network-policy.md (1)

44-47: ⚡ Quick win

Use MyST admonition syntax for this callout block.

This section uses GitHub-style blockquote admonition (> [!IMPORTANT]) in docs/**; switch it to a MyST admonition block to match the docs style guide.

As per coding guidelines: “Use MyST admonitions (:::{tip}, :::{note}, :::{warning}) for callouts, not bold text or blockquotes.”

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/network-policy/customize-network-policy.md` around lines 44 - 47,
Replace the GitHub-style blockquote admonition that begins with "> [!IMPORTANT]"
and its following lines with a MyST admonition block: wrap the same content
between an opening "::: important" and a closing ":::", preserving inline code
(e.g., `vi`, `jq`, `dos2unix`) and line breaks, so the three lines currently
quoted become a single MyST block (:::{important} content :::). Ensure the
admonition tag is "important" (or the project-standard equivalent) and there are
blank lines before and after the admonition per MyST formatting rules.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@docs/network-policy/customize-network-policy.md`:
- Around line 44-47: Replace the GitHub-style blockquote admonition that begins
with "> [!IMPORTANT]" and its following lines with a MyST admonition block: wrap
the same content between an opening "::: important" and a closing ":::",
preserving inline code (e.g., `vi`, `jq`, `dos2unix`) and line breaks, so the
three lines currently quoted become a single MyST block (:::{important} content
:::). Ensure the admonition tag is "important" (or the project-standard
equivalent) and there are blank lines before and after the admonition per MyST
formatting rules.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: e2e62b10-6d8f-4eb2-bfbc-a4936150b990

📥 Commits

Reviewing files that changed from the base of the PR and between a4a9eb0 and 5098302.

📒 Files selected for processing (11)
  • .agents/skills/nemoclaw-user-deploy-remote/references/sandbox-hardening.md
  • .agents/skills/nemoclaw-user-manage-policy/SKILL.md
  • .agents/skills/nemoclaw-user-manage-sandboxes/references/messaging-channels.md
  • .agents/skills/nemoclaw-user-reference/references/network-policies.md
  • .agents/skills/nemoclaw-user-reference/references/troubleshooting.md
  • docs/deployment/sandbox-hardening.md
  • docs/manage-sandboxes/messaging-channels.md
  • docs/network-policy/customize-network-policy.md
  • docs/project.json
  • docs/reference/network-policies.md
  • docs/versions1.json

Co-authored-by: Cursor <cursoragent@cursor.com>
@jyaunches jyaunches merged commit 37050a6 into main May 8, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation v0.0.37 Release target

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants