Skip to content

Update Cloud CLI deploy documentation for link-first workflow - #3306

Merged
pwizla merged 9 commits into
mainfrom
repo/update-cloud-cli-deploy-behavior
Jul 1, 2026
Merged

Update Cloud CLI deploy documentation for link-first workflow#3306
pwizla merged 9 commits into
mainfrom
repo/update-cloud-cli-deploy-behavior

Conversation

@mariekirsch

@mariekirsch mariekirsch commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Update Cloud CLI docs so strapi deploy requires a linked Strapi Cloud project and document the login → link → deploy order.
  • Rewrite the quick start Part C to recommend dashboard deployment via GitHub instead of terminal-only deploy.
  • Update homepage deploy card
Document that deploy requires a linked Cloud project, recommend dashboard deployment in the quick start, and fix the strapi-link heading anchor.

Co-authored-by: Cursor <cursoragent@cursor.com>
@mariekirsch
mariekirsch requested a review from pwizla as a code owner June 30, 2026 21:13
@vercel

vercel Bot commented Jun 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment Jul 1, 2026 12:45pm

Request Review

@github-actions github-actions Bot added pr: updated content PRs updating existing documentation content source: repo PRs/issues not targeting a specific documentation but rather affecting the whole repo labels Jun 30, 2026
@mariekirsch mariekirsch added the source: Strapi Cloud PRs/issues targeting the Strapi Cloud documentation label Jun 30, 2026
@mariekirsch mariekirsch self-assigned this Jun 30, 2026
@mariekirsch mariekirsch added the internal PRs created by the Strapi core team label Jun 30, 2026
The Push to GitHub and Create/deploy Cloud subsections were plain headings inconsistent with the rest of the guide. Turn them into StepDetails steps, renumber Part D to steps 7-12, update the Tldr count, and fix the REST API anchor link.
init, add, and commit are combined into a single code block, and the remote/push commands each get their own block. The step goes from 8 bullets to 5.
The git commands are short and not copy-pasted verbatim (remote add and push need editing), so terminal blocks drew undue attention. Commands now sit inline, and remote add and push are merged into one bullet.
The bullet now states what to do on the first line, then the concrete commands after a <br/>, so the goal reads clearly before the git syntax.
The QSG and the CLI installation page duplicated the same git push instructions. Move them to docs/snippets/push-to-github.md (togglable details) and import it in both pages. In the QSG, the detailed steps now sit behind the toggle so they no longer draw attention on a developer-facing section. Repo name harmonized to my-strapi-project.

@pwizla pwizla left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks a lot, Marie!

Mergeable once we replace the GIF for Cloud.
As discussed on Slack, I reworked the git section and tweaked the new steps to include them in the progress indicator.

@pwizla pwizla removed the source: repo PRs/issues not targeting a specific documentation but rather affecting the whole repo label Jul 1, 2026
@pwizla pwizla added this to the 7.0.1 milestone Jul 1, 2026
@pwizla pwizla added the flag: merge pending release Waiting for the related product PR to be merged before merging this documentation PR label Jul 1, 2026
@pwizla

pwizla commented Jul 1, 2026

Copy link
Copy Markdown
Collaborator

GIFs updated ✅
Ready to merge whenever you are 🚀

@pwizla pwizla removed the flag: merge pending release Waiting for the related product PR to be merged before merging this documentation PR label Jul 1, 2026
@pwizla
pwizla merged commit 4766455 into main Jul 1, 2026
4 of 5 checks passed
@pwizla
pwizla deleted the repo/update-cloud-cli-deploy-behavior branch July 1, 2026 15:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: Strapi Cloud PRs/issues targeting the Strapi Cloud documentation

2 participants