Skip to content

docs: remove duplicated content from CLI reference page#261

Merged
danielmeppiel merged 2 commits intomainfrom
docs/cleanup-cli-reference
Mar 12, 2026
Merged

docs: remove duplicated content from CLI reference page#261
danielmeppiel merged 2 commits intomainfrom
docs/cleanup-cli-reference

Conversation

@danielmeppiel
Copy link
Collaborator

Summary

The CLI Commands reference page (/reference/cli-commands) was bloated with content duplicated from other pages. This PR strips it down to a pure CLI reference.

Removed sections

Section Reason
Quick Start (top) Duplicates getting-started/quick-start
Installation Duplicates getting-started/installation
File Formats Overlaps reference/manifest-schema and reference/primitive-types
Quick Start Workflow (bottom) Another quick-start duplicate
Tips & Best Practices Generic advice, not command reference
Integration Examples Belongs in guides
Project Structure Example Not CLI reference material

What changed

  • Removed 179 lines of duplicated/misplaced content
  • Added a brief intro with cross-links to the Installation and Quick Start pages
  • All command documentation (Global Options through Runtime commands) is untouched

Result

1243 lines → 1068 lines. The page is now a focused CLI reference.

The CLI Commands reference page duplicated content from the Quick Start
and Installation pages, and included non-reference material (tips,
integration examples, file formats, project structure). Removed 179
lines and replaced with a brief intro linking to the canonical pages.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 12, 2026 13:00
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR trims the CLI Commands reference page by removing ~179 lines of content that duplicated information already available on other documentation pages (Installation, Quick Start, Manifest Schema, etc.). A brief Starlight tip callout with cross-links replaces the removed introductory sections.

Changes:

  • Removed duplicated Quick Start, Installation, File Formats, Tips & Best Practices, Integration Examples, and Project Structure sections
  • Added a :::tip callout linking to the Installation and Quick Start pages
  • All actual command documentation (Global Options through Runtime commands) is untouched

@danielmeppiel danielmeppiel merged commit a5b33bb into main Mar 12, 2026
6 checks passed
@danielmeppiel danielmeppiel deleted the docs/cleanup-cli-reference branch March 12, 2026 20:06
Copilot AI added a commit that referenced this pull request Mar 12, 2026
… drift.py scope

- CHANGELOG: consolidate 3-line entry to single line per project convention;
  correct PR reference from #261 to #260
- drift.py: add Scope / non-goals section documenting what IS handled
  (hash-based refs, URL format normalization) and what is NOT
  (source/host changes require apm remove + install or --update)

Co-authored-by: danielmeppiel <51440732+danielmeppiel@users.noreply.github.com>
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