Skip to content

docs: use Public Preview consistently for project templates - #3447

Open
NickJosevski wants to merge 1 commit into
mainfrom
nj/project-templates-public-preview-consistency
Open

docs: use Public Preview consistently for project templates#3447
NickJosevski wants to merge 1 commit into
mainfrom
nj/project-templates-public-preview-consistency

Conversation

@NickJosevski

Copy link
Copy Markdown
Contributor

What

Two pages still describe project templates as being in Alpha, while the rest of the project templates documentation describes them as being in Public Preview.

  • platform-hub/templates/index.md — "Project templates are currently in Alpha"
  • platform-hub/templates/project-templates/troubleshooting.md — "The Alpha release doesn't support creating and managing project templates through the REST API"

Both now say Public Preview. modDate bumped on both pages.

Why Public Preview is the correct status

  • 12 occurrences of "Public Preview" across the project templates pages vs 2 of "Alpha".
  • The two Alpha references sit on pages with older modDate values (2026-03-06 and 2026-05-28) than the pages using Public Preview, so they read as stale rather than as a deliberate distinction.
  • project-templates/installation-guide.md is titled "Installing the Public Preview of project templates".

Out of scope

platform-hub/compliance-reports.md also says "Alpha", but that's a separate feature with its own status and it's labelled consistently on its own page. Left untouched — flagging in case compliance reports have since moved to Public Preview too, which would be a follow-up.

Checks

  • cspell clean on both changed files.
  • No markdownlint risk: changes are in-line word substitutions and MD013 (line length) is disabled in .markdownlint.json.
  • CRLF line endings preserved.

Reviewer note

The mechanical consistency is easy to verify from the diff. The thing a tool can't check is whether Public Preview is genuinely the current status of project templates — please confirm against the current release state before merging.

🤖 Generated with Claude Code

@team-marketing-branch-protections

Copy link
Copy Markdown

Pull request environment is available at https://stoctodocspr3447.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.

@NickJosevski
NickJosevski force-pushed the nj/project-templates-public-preview-consistency branch from 16cca4f to ca9d266 Compare September 4, 2026 02:50

@IsaacCalligeros95 IsaacCalligeros95 left a comment

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.

LGTM, we've got a few docs updates to make in the next week or two around channels & lifecycles. I'll make sure we do a bit of a sanity check across everything for things like this.

Two pages still described project templates as being in Alpha, while the
rest of the project templates documentation describes them as being in
Public Preview. Both stale references are on pages with older modDates
than the pages using Public Preview, so Public Preview is the current
status.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@NickJosevski
NickJosevski force-pushed the nj/project-templates-public-preview-consistency branch from ca9d266 to 2b28170 Compare September 4, 2026 03:28
@NickJosevski
NickJosevski enabled auto-merge (rebase) September 4, 2026 03:28
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.

3 participants