Skip to content

Update docs for Project Templates Public Preview#3185

Merged
felixi-octopus merged 3 commits into
mainfrom
felix/projecttemplatedocs
May 28, 2026
Merged

Update docs for Project Templates Public Preview#3185
felixi-octopus merged 3 commits into
mainfrom
felix/projecttemplatedocs

Conversation

@felixi-octopus
Copy link
Copy Markdown
Contributor

@felixi-octopus felixi-octopus commented May 28, 2026

Closes MAS-2828
Closes MAS-2645

Background

Project Templates is being released as a Public Preview feature in the 2026.2 Octopus Server release. These are the accompanying docs changes.

Summary

  • Update all Project Templates pages from Alpha to Public Preview.
  • Document the new variable types (certificates) and scoping options now supported in templates.
  • Add a Project settings section covering Multi-tenant Deployments and Project Persistence.
  • Update the installation guide to point to octopus.com/downloads.
  • Update the Public Preview limitations list to reflect what's now supported.
  • Move Certificate parameters to the list of types that can have a default value.
  • Copy and consistency fixes.

@felixi-octopus felixi-octopus force-pushed the felix/projecttemplatedocs branch from fc97916 to 71e9cb9 Compare May 28, 2026 05:44
@team-marketing-branch-protections
Copy link
Copy Markdown

Pull request environment is available at https://stoctodocspr3185.z22.web.core.windows.net.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.

Copy link
Copy Markdown
Contributor

@david-wu-octopus david-wu-octopus left a comment

Choose a reason for hiding this comment

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

I left some comments. I'll leave the approval for @MissedTheMark

Comment thread src/pages/docs/platform-hub/templates/project-templates/best-practices.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/index.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/index.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/installation-guide.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/troubleshooting.md Outdated
Copy link
Copy Markdown
Contributor

@MissedTheMark MissedTheMark left a comment

Choose a reason for hiding this comment

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

Just a couple of minor comments, but overall really nice work 👍

I really appreciate the improvements you've made to existing wording etc too, thanks for that!


The project template process editor shows a warning callout when included process templates have received automatic updates since the template was last published. Use it to review the changes before publishing a new version.

We're interested in your [feedback](#feedback) on whether this behavior meets your expectations.
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.

Nice addition 👍

Comment thread src/pages/docs/platform-hub/templates/project-templates/index.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/index.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/troubleshooting.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/troubleshooting.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/troubleshooting.md Outdated
Comment thread src/pages/docs/platform-hub/templates/parameters.md
![Configuring template version update preferences](/docs/img/platform-hub/project-templates/templated-project-version-settings.png)
:::

<!-- markdownlint-enable MD029 -->
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.

Needed to correct numbering and retain a green lint check

Comment thread src/pages/docs/platform-hub/templates/project-templates/best-practices.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/index.md Outdated
Comment thread src/pages/docs/platform-hub/templates/project-templates/index.md Outdated
## Feedback

Project templates are in Alpha and we're actively shaping how the feature works. If you run into something unexpected or have thoughts on how parameters, variables, scoping, or anything else should work, we'd love to hear from you. [Share your feedback](https://oc.to/feedback) to help us build this the right way.
Project templates are in Public Preview and we're actively shaping how the feature works. If you run into something unexpected or have thoughts on how parameters, variables, scoping, or anything else should work, we'd love to hear from you. [Share your feedback](https://oc.to/feedback) to help us build this the right way.
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.

Suggested change
Project templates are in Public Preview and we're actively shaping how the feature works. If you run into something unexpected or have thoughts on how parameters, variables, scoping, or anything else should work, we'd love to hear from you. [Share your feedback](https://oc.to/feedback) to help us build this the right way.
Project templates are in Public Preview and we're actively shaping how the feature works. If you run into something unexpected or have thoughts on how parameters, variables, scoping, or anything else should work, we'd love to hear from you. [Share your feedback](https://roadmap.octopus.com/c/263-project-templates) to help us build this the right way.


:::div{.warning}
Project templates are in Alpha. The feature is incomplete and standard SLAs do not apply. Don't use it for production workloads. It is available to Enterprise customers on Cloud. Self-hosted customers can access it as an early preview via Octopus 2026.2. We're actively developing this feature and would love your feedback.
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability.
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.

Suggested change
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability.
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability, [tell us what you think.](https://roadmap.octopus.com/c/263-project-templates)..


:::div{.warning}
Project templates are in Alpha. The feature is incomplete and standard SLAs do not apply. Don't use it for production workloads. It is available to Enterprise customers on Cloud. Self-hosted customers can access it as an early preview via Octopus 2026.2. We're actively developing this feature and would love your feedback.
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability.
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.

Suggested change
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability.
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability, [tell us what you think.](https://roadmap.octopus.com/c/263-project-templates).


:::div{.warning}
Project templates are in Alpha. The feature is incomplete and standard SLAs do not apply. Don't use it for production workloads. It is available to Enterprise customers on Cloud. Self-hosted customers can access it as an early preview via Octopus 2026.2. We're actively developing this feature and would love your feedback.
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability.
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.

Suggested change
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability.
Project templates are in Public Preview. The feature is still evolving and standard SLAs don't apply. We don't recommend it for production workloads yet. It's available to Enterprise customers on Cloud and to self-hosted customers running Octopus 2026.2. We'd love your feedback as we work towards general availability, [tell us what you think.](https://roadmap.octopus.com/c/263-project-templates).

@felixi-octopus felixi-octopus merged commit 890f4bd into main May 28, 2026
5 checks passed
@felixi-octopus felixi-octopus deleted the felix/projecttemplatedocs branch May 28, 2026 23:37
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