Skip to content

docs: Projects pre-release - #4993

Draft
brianmacdonald-temporal wants to merge 10 commits into
mainfrom
projects-feature-docs
Draft

docs: Projects pre-release#4993
brianmacdonald-temporal wants to merge 10 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 Jul 31, 2026 8:46pm

Request Review

Comment thread docs/cloud/projects.mdx
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

In the Temporal UI, click **Projects** at the top of the left navigation bar, under **Your Account**. You'll see a list of existing Projects associated with your Account. The first time you use Projects, you'll only see the Default Project in this list.

Click the **Create Project** button to create a new Project. On the **Create Project** page that appears, give the Project a name (limited to 39 characters) and an optional description. Click **Create** and you'll be taken to the page for your new Project. You cannot currently migrate resources from existing Projects to a new Project. Instead, from this page click **Create Namespace** to add a new Namespace to this Project. To add a Nexus Endpoint instead, click **Nexus Endpoints** in the left navigation and then click the **Create Nexus Endpoint** button.

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.

Click the Create Project button to create a new Project. On the Create Project page that appears, give the Project a name (limited to 64 characters) and an optional description(limited to 255 characters). Click Create and you'll be taken to the page for your new Project. You cannot currently migrate resources from existing Projects to a new Project yet in Pre-release. Instead, from this page click Create Namespace to add a new Namespace to this Project. To add a Nexus Endpoint instead, click Nexus Endpoints in the left navigation and then click the Create Nexus Endpoint button.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I'm trying not to refer to a release stage or make forward-looking statements. The doc describes the functionality as it currently exists.
I realize that we're going to add the ability to migrate resources shortly, which is why I used "currently" in the original text. Once that feature is added, we'll update this text.

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

## Project roles

The following six roles are available at the Project level for users, groups, and service accounts:

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.

can we add a placeholder to refer to the permission reference with details?
https://docs.temporal.io/cloud/manage-access/permissions-reference

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>
Co-authored-by: Lutao X <lutao.xie@temporal.io>
Comment thread docs/cloud/projects.mdx
Click the **Create Project** button to create a new Project. On the **Create Project** page that appears, give the Project a name (limited to 64 characters) and an optional description (limited to 255 characters). Click **Create** and you'll be taken to the page for your new Project. You cannot currently migrate resources from existing Projects to a new Project. Instead, from this page click **Create Namespace** to add a new Namespace to this Project. To add a Nexus Endpoint instead, click **Nexus Endpoints** in the left navigation and then click the **Create Nexus Endpoint** button.


## Add Resources to a Project {/* #add-resources-to-a-project */}

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.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Add Resources to a Project ***********************************' should use sentence-style capitalization.

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