docs(cloud): rename apps to projects across the portal documentation - #137
Merged
lukekim merged 1 commit intoAug 2, 2026
Merged
Conversation
Align the Cloud portal docs with the portal's Project terminology, and correct the delete, transfer, publish, tags, and API key flows against the current portal UI.
lukekim
approved these changes
Aug 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The Cloud portal now calls the resource a Project everywhere a customer sees it — navigation, command menu, create flow, settings panels, danger-zone actions, public organization pages, and OAuth consent screens. The portal docs still said "App", so every page in the Portal section described labels that no longer exist in the product.
This renames the user-visible terminology across the Portal and Getting Started pages, and corrects several step-by-step flows that were already wrong against the current UI.
Deliberately not changed, because they are contracts rather than copy:
/docs/portal/apps/...) — a URL rename needs redirects and is a separate decision.apps:read/apps:write/apps:delete, which are unchanged and already documented as such in the Management API reference.Pages updated
Projects section
cloud/portal/apps/README.md— "Apps" → "Projects"; note on the rename and the legacy API paths.cloud/portal/apps/delete.md— Delete flow: the danger-zone button is Delete project, the dialog is Delete Project, and confirmation requires typing<org-name>/<project-name>(the page previously said the project name alone) and clicking Delete. Replaced a link to a page that no longer exists with the Management APIs reference.cloud/portal/apps/transfer.md— Transfer flow: Transfer project button, Transfer project page,<org-name>/<project-name>confirmation, Transfer & redeploy project submit. Added that transfer requires organization admin permissions and is blocked while a GitHub repository is connected. Repaired a broken organization link.cloud/portal/apps/publish.md— Section is Project visibility; the control is Publish project / Make private with a confirmation dialog. Added the prerequisites: a connected public GitHub repository, and that viewers cannot change visibility.cloud/portal/apps/api-keys.md— Key regeneration lives in Danger Zone, not under General, and the button reads Regenerate key.cloud/portal/apps/tags.md— Save control is Save Tags followed by a confirmation; noted that reserved, platform-managed tag keys are hidden from the editor.cloud/portal/apps/connect-github.md— Section is Connect Git Repository (Connected Git Repository once linked, with a Production Branch selector and Disconnect). Fixed duplicated step numbering.cloud/portal/apps/secrets.md,runtime.md— terminology only.Related Portal pages
cloud/portal/public-apps.md— "Public Apps" → "Public Projects"; publishing steps match the current control.cloud/portal/app-spicepod/*— "App Spicepod" → "Project Spicepod"; terminology in deployment statuses and the Issues panel.cloud/portal/spicerack.md— references to public projects.Getting Started
cloud/getting-started/getting-started/portal-login-1.md— "Create a Spice app" → "Create a Spice project"; the create button is Create project.cloud/getting-started/get-started/*— terminology in the remaining steps.Navigation
cloud/SUMMARY.md— nav labels: Projects, Public Projects, Project Spicepod, Create a Spice project.Notes for the reviewer
cloud/portal/playground/,monitoring-and-request-logs.md,organizations.md, andorganization-secrets.md; one reference insdks/README.md; and a broken link to a removed Management API page inhelp/apis-and-sdks.md.cloud/portal/apps/delete.md,transfer.md,app-spicepod/README.md, andget-started/next-steps.mdfor link repairs. The overlaps are textual and small — this PR makes the same organization-link fix ontransfer.md, and ondelete.mdit drops the dead#delete-appanchor rather than re-pointing to it.Verification
https://spice.ai/spiceairenders "Projects", and the Management API's canonical/v1/projectsroutes are published in the API reference. All UI labels quoted above were read from the shipped implementation, not inferred.SUMMARY.mdadditions needed beyond the relabelled entries{% hint %}syntax used, not:::admonitions