Sitelet https://github.com/OctopusDeploy/docs/pull/3472
Skip to content

Document the modulo calc operator and HashBucket filter - #3472

Open
droyad wants to merge 4 commits into
mainfrom
robw/octostache-docs-update-1b4de8
Open

droyad wants to merge 4 commits into
mainfrom
robw/octostache-docs-update-1b4de8

Conversation

@droyad

@droyad droyad commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Octostache added two new pieces of variable-substitution syntax last week:

This PR documents both:

  • Variable substitution syntax — adds modulo to the calc operators, an example, and notes on its whole-number-only behaviour, the zero-divisor case, and why it doesn't need the brace-escaping -// require
  • Variable filters — adds HashBucket to the conversion filters table with a behaviour table and its error-message format for an invalid bucket count

Octostache added a modulo operator to calc expressions and a HashBucket
variable filter last week (OctopusDeploy/Octostache#146 and #144).
Documents their syntax and behaviour, including the whole-number/zero-divisor
edge cases for modulo and the error format for an invalid HashBucket count.

The self-hosted Octopus Server version each ships in isn't known yet (no
release has picked them up), so both are left as PLACEHOLDER markers in the
Version notes sections pending confirmation.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Comment thread src/pages/docs/projects/variables/variable-filters.md Outdated
Comment thread src/pages/docs/projects/variables/variable-filters.md Outdated
Comment thread src/pages/docs/projects/variables/variable-substitutions.mdx Outdated
Comment thread src/pages/docs/projects/variables/variable-filters.md Outdated
droyad and others added 2 commits September 22, 2026 15:26
Co-authored-by: Robert Wagner <robert@wagner.id.au>
MD060 flagged the new HashBucket rows/tables for inconsistent pipe
alignment against their headers. Re-aligns all three tables.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@team-marketing-branch-protections

Copy link
Copy Markdown

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

# Conflicts:
#	src/pages/docs/projects/variables/variable-filters.md
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