Skip to content

Prepare doc for next release#281

Merged
vincent-psarga merged 1 commit intomainfrom
doc/update-install-documentation
Apr 14, 2026
Merged

Prepare doc for next release#281
vincent-psarga merged 1 commit intomainfrom
doc/update-install-documentation

Conversation

@vincent-psarga
Copy link
Copy Markdown
Contributor

@vincent-psarga vincent-psarga commented Apr 13, 2026

Update documentation about install command for the next release

Summary by CodeRabbit

  • Documentation
    • Updated CLI command examples to reflect new command structure and namespace
    • Package management commands reorganized under packmind-cli packages prefix (list and show)
    • Recursive installation behavior is now default; explicit flags no longer needed
    • Updated authentication and installation examples across setup and distribution guides

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 13, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e4f67073-d7ea-4a4a-8040-1493bca6b9d1

📥 Commits

Reviewing files that changed from the base of the PR and between 4500df6 and 6ad2fb2.

📒 Files selected for processing (5)
  • apps/doc/concepts/packages-management.mdx
  • apps/doc/getting-started/gs-cli-setup.mdx
  • apps/doc/getting-started/gs-distribute.mdx
  • apps/doc/governance/distribution.mdx
  • apps/doc/tools/cli.mdx

📝 Walkthrough

Walkthrough

This PR updates Packmind CLI documentation across multiple files to reflect command syntax changes. Key updates include: replacing install --list with packages list, replacing install --show with packages show, changing an npx example from install --list to login, removing the deprecated --recursive flag, and adding scoped packages installation examples.

Changes

Cohort / File(s) Summary
Package List & Show Commands
apps/doc/getting-started/gs-distribute.mdx, apps/doc/tools/cli.mdx
Updated CLI commands from packmind-cli install --list to packmind-cli packages list and packmind-cli install --show <package-slug> to packmind-cli packages show <package-slug>.
Authentication & Monorepo Guidance
apps/doc/getting-started/gs-cli-setup.mdx, apps/doc/governance/distribution.mdx, apps/doc/tools/cli.mdx
Changed npx @packmind/cli install --list to npx @packmind/cli login, removed deprecated --recursive flag from documentation, and added scoped packages installation examples.
Simple Command Removal
apps/doc/concepts/packages-management.mdx
Removed the packmind-cli install --list CLI snippet from installation instructions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

Suggested reviewers

  • MaloPromyze

Poem

🐰 Commands shift like carrots rearranged,
From install --list to packages changed,
The docs hop forward, recursive flags removed,
Scoped packages bloom—authentication improved! 🥕

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/update-install-documentation

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

@mintlify
Copy link
Copy Markdown

mintlify Bot commented Apr 13, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
packmind 🟢 Ready View Preview Apr 13, 2026, 12:33 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@sonarqubecloud
Copy link
Copy Markdown

@vincent-psarga vincent-psarga marked this pull request as ready for review April 14, 2026 08:11
@vincent-psarga vincent-psarga merged commit 65cbd5c into main Apr 14, 2026
21 of 22 checks passed
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 14, 2026

Greptile Summary

This PR updates documentation ahead of the next CLI release, replacing deprecated install --list / install --show / install -r invocations with the new packages list, packages show, and bare packmind-cli install forms, and removes the now-obsolete deprecation warning for --recursive. The npx quick-start example in the setup guide is also corrected to use login instead of install --list.

Confidence Score: 5/5

  • Safe to merge — all changes are documentation-only and correctly align with the upcoming CLI release.
  • All findings are P2 style/consistency suggestions (missing command in overview, code-block clarity). There are no logic errors, broken links, or incorrect commands introduced. The core documentation updates are accurate and internally consistent across the five changed files.
  • apps/doc/tools/cli.mdx — packages show is absent from the top-level command overview list.

Important Files Changed

Filename Overview
apps/doc/tools/cli.mdx Updated install examples and CI/CD snippet to remove deprecated -r flag; moved list/show package subcommands from install --list/--show to packages list/packages show; removed stale deprecation warning. Minor inconsistency: packages show is documented in the Install section but is absent from the top-level command overview.
apps/doc/getting-started/gs-distribute.mdx Updated list/show package commands from install --list/--show to packages list/packages show, consistent with cli.mdx changes.
apps/doc/governance/distribution.mdx Removed --recursive flag from monorepos use-case bullet; added multi-space @space/package syntax as a comment+second command in the same code block, which may confuse readers into thinking both commands should be run.
apps/doc/getting-started/gs-cli-setup.mdx Replaced npx quick-start example from install --list to login, which is a more appropriate first-use example for an installation guide.
apps/doc/concepts/packages-management.mdx Removed the install --list code snippet that was redundant; no other logic changes.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User] --> B[packmind-cli login]
    B --> C{Browse packages?}
    C -->|Yes| D[packmind-cli packages list]
    D --> E[packmind-cli packages show package-slug]
    E --> F{Ready to install}
    C -->|No, direct install| F
    F --> G{Single space?}
    G -->|Yes| H["packmind-cli install pkg1 pkg2"]
    G -->|Multiple spaces| I["packmind-cli install @space/pkg1 @space2/pkg2"]
    H --> J[packmind-lock.json created]
    I --> J
    J --> K[packmind-cli install — update all from packmind.json]
Loading

Reviews (1): Last reviewed commit: "Prepare doc for next release" | Re-trigger Greptile

Comment thread apps/doc/tools/cli.mdx
Comment on lines 451 to 455
### View Package Details

```bash
packmind-cli install --show <package-slug>
packmind-cli packages show <package-slug>
```
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.

P2 packages show missing from command overview

The top-level command overview (the bullet list near the top of the file) lists packages create, packages add, and packages list, but packages show — which is newly introduced by this PR as a replacement for install --show — is absent. A user scanning the overview for what packages subcommands exist will miss it.

Suggested change
### View Package Details
```bash
packmind-cli install --show <package-slug>
packmind-cli packages show <package-slug>
```
### View Package Details
```bash
packmind-cli packages show <package-slug>

Consider also adding a `packages show` entry to the overview list alongside `packages list`.

Comment on lines 78 to 83
```bash
packmind-cli install backend-standards frontend-react
# Note: when using multiple spaces, you will need to prefix the packages with the space slug
packmind-cli install @backend/standards @frontend/react
```

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.

P2 Code block mixes two mutually exclusive alternatives

Placing both packmind-cli install backend-standards frontend-react and packmind-cli install @backend/standards @frontend/react in the same code block (with only an inline comment to differentiate them) can make it appear that a user should run both commands. Because these are alternative forms depending on whether packages live in one space or multiple, splitting them into separate blocks with a brief prose explanation would be clearer.

Suggested change
```bash
packmind-cli install backend-standards frontend-react
# Note: when using multiple spaces, you will need to prefix the packages with the space slug
packmind-cli install @backend/standards @frontend/react
```
```bash
packmind-cli install backend-standards frontend-react

If your packages are in different spaces, prefix them with the space slug:

packmind-cli install @backend/standards @frontend/react


Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

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