[PR #725] [MERGED] docs(readme): adopt onboarding-first structure #742

Closed
opened 2026-02-26 22:32:21 +03:00 by kerem · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/725
Author: @rudrankriyam
Created: 2/22/2026
Status: Merged
Merged: 2/22/2026
Merged by: @rudrankriyam

Base: mainHead: docs/readme-onboarding-split


📝 Commits (3)

  • 5e23c03 docs(readme): split onboarding from command reference
  • 6fc290a ci(docs): enforce command reference sync
  • 1f0c4ee docs(commands): generate command reference from CLI help

📊 Changes

7 files changed (+592 additions, -1645 deletions)

View changed files

📝 .github/workflows/main-branch.yml (+3 -0)
📝 .github/workflows/pr-checks.yml (+3 -0)
📝 Makefile (+15 -0)
📝 README.md (+86 -1645)
docs/COMMANDS.md (+178 -0)
scripts/check-commands-docs.py (+114 -0)
scripts/generate-command-docs.py (+193 -0)

📄 Description

Summary

  • refactor README.md into an onboarding-first layout (quick start, common workflows, CI integrations, and key docs links)
  • move deep command navigation out of README into a dedicated docs/COMMANDS.md reference guide
  • keep Wall of Apps snippet markers and existing project metadata sections while reducing README sprawl

Why

  • align with industry CLI docs patterns where README is a fast landing page and full reference lives in dedicated docs
  • improve first-time scanning and reduce cognitive load without losing command discoverability

Impact

  • README.md reduced from ~1862 lines to ~302 lines
  • new docs/COMMANDS.md (~172 lines) provides command-family index and usage discovery patterns

Test plan

  • make update-wall-of-apps
  • make format
  • make lint
  • ASC_BYPASS_KEYCHAIN=1 make test

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/725 **Author:** [@rudrankriyam](https://github.com/rudrankriyam) **Created:** 2/22/2026 **Status:** ✅ Merged **Merged:** 2/22/2026 **Merged by:** [@rudrankriyam](https://github.com/rudrankriyam) **Base:** `main` ← **Head:** `docs/readme-onboarding-split` --- ### 📝 Commits (3) - [`5e23c03`](https://github.com/rudrankriyam/App-Store-Connect-CLI/commit/5e23c033642b797f073ae167d4f0babc540a7ebd) docs(readme): split onboarding from command reference - [`6fc290a`](https://github.com/rudrankriyam/App-Store-Connect-CLI/commit/6fc290afff2d3c682bfe140749e750fa172f9ea9) ci(docs): enforce command reference sync - [`1f0c4ee`](https://github.com/rudrankriyam/App-Store-Connect-CLI/commit/1f0c4ee94b782b9a88c3e75f86b1d238da96d587) docs(commands): generate command reference from CLI help ### 📊 Changes **7 files changed** (+592 additions, -1645 deletions) <details> <summary>View changed files</summary> 📝 `.github/workflows/main-branch.yml` (+3 -0) 📝 `.github/workflows/pr-checks.yml` (+3 -0) 📝 `Makefile` (+15 -0) 📝 `README.md` (+86 -1645) ➕ `docs/COMMANDS.md` (+178 -0) ➕ `scripts/check-commands-docs.py` (+114 -0) ➕ `scripts/generate-command-docs.py` (+193 -0) </details> ### 📄 Description ## Summary - refactor `README.md` into an onboarding-first layout (quick start, common workflows, CI integrations, and key docs links) - move deep command navigation out of README into a dedicated `docs/COMMANDS.md` reference guide - keep Wall of Apps snippet markers and existing project metadata sections while reducing README sprawl ## Why - align with industry CLI docs patterns where README is a fast landing page and full reference lives in dedicated docs - improve first-time scanning and reduce cognitive load without losing command discoverability ## Impact - `README.md` reduced from ~1862 lines to ~302 lines - new `docs/COMMANDS.md` (~172 lines) provides command-family index and usage discovery patterns ## Test plan - [x] `make update-wall-of-apps` - [x] `make format` - [x] `make lint` - [x] `ASC_BYPASS_KEYCHAIN=1 make test` --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
kerem 2026-02-26 22:32:21 +03:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/App-Store-Connect-CLI#742
No description provided.