Skip to content

docs: Projects pre-release - #4993

Merged
Duncanma merged 34 commits into
mainfrom
projects-feature-docs
Aug 7, 2026
Merged

docs: Projects pre-release#4993
Duncanma merged 34 commits into
mainfrom
projects-feature-docs

Conversation

@brianmacdonald-temporal

@brianmacdonald-temporal brianmacdonald-temporal commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Creates Cloud/Projects page for pre-release for new Projects feature.

Notes to reviewers

A matrix for permission interactions still needs to be added.

┆Attachments: EDU-6847 docs: Projects pre-release

@brianmacdonald-temporal
brianmacdonald-temporal requested a review from a team as a code owner July 29, 2026 20:50
@vercel

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview Aug 7, 2026 4:41pm

Request Review

Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx
Comment thread docs/cloud/projects.mdx
@github-actions

github-actions Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Co-authored-by: Lutao X <lutao.xie@temporal.io>
Co-authored-by: Lutao X <lutao.xie@temporal.io>
brianmacdonald-temporal and others added 3 commits July 30, 2026 16:28
Co-authored-by: Lutao X <lutao.xie@temporal.io>
Co-authored-by: Lutao X <lutao.xie@temporal.io>
Co-authored-by: Lutao X <lutao.xie@temporal.io>
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
Once Projects are enabled, existing Accounts receive a Default Project, and new Accounts are created with one automatically. For existing Accounts, all existing resources are automatically placed in the Default Project. Existing role assignments and effective permissions remain unchanged. For new Accounts, the Default Project is created automatically. New resources are automatically placed in the Default Project unless you specify otherwise.


## Default Project and Project names

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.

Should we say Default Project and Project ID instead? Project ID is something net new we are introducing.

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.

+1

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.

Alternatively, have one section that explains default projects, and a separate section explaining ID usage vs name

Comment thread docs/cloud/manage-access/permissions-reference.mdx Outdated
Comment thread docs/cloud/projects.mdx Outdated
<ReleaseNoteHeader featureName="projects">
Features in pre-release are experimental and may be subject to backwards-incompatible changes.

Projects currently support the Temporal UI and Temporal Cloud Ops API.

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.

This sentence sounds strange.

  1. You can see the object (Projects) via different interfaces (UI, API). Current ordering feels backwards.
  2. What does the user do with this info? Is this implying Projects aren't visible in the CLI?

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.

I dropped the second line for now, I don't think it is critical and the meaning/intent is unclear

Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx
Duncanma and others added 2 commits August 7, 2026 08:33
Co-authored-by: Lutao X <lutao.xie@temporal.io>
Co-authored-by: Lutao X <lutao.xie@temporal.io>
Comment thread docs/cloud/projects.mdx Outdated
Comment thread docs/cloud/projects.mdx
Clarified the description of pre-release features and their backward compatibility.
@Duncanma
Duncanma merged commit 88d97c1 into main Aug 7, 2026
15 checks passed
@Duncanma
Duncanma deleted the projects-feature-docs branch August 7, 2026 16:42
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.

5 participants