Skip to content

docs: durable & async Fission RFC series (statestore, async invocation, workflows) - #314

Draft
sanketsudake wants to merge 26 commits into
mainfrom
docs/durable-async-rfc-series
Draft

docs: durable & async Fission RFC series (statestore, async invocation, workflows)#314
sanketsudake wants to merge 26 commits into
mainfrom
docs/durable-async-rfc-series

Conversation

@sanketsudake

@sanketsudake sanketsudake commented Jul 19, 2026

Copy link
Copy Markdown
Member

Docs e2e sync: durable & async RFC series (0021–0030) + reference regen + freshness pass

Documents the full RFC 0021–0030 feature wave from the shipped surface (verified against fission source, not RFC text), regenerates the reference docs, fixes verified staleness on older pages, and applies a Simplified-Technical-English/clarity pass across every touched page.

Feature docs (one guide per RFC)

  • 0021 architecture/statestore.md — durable substrate, embedded SQLite vs external Postgres.
  • 0022 concepts/workflows.md + usage/workflows/ — authoring, run-and-inspect, worked examples.
  • 0023 usage/function/keyed-state.md — keyed state, fission function state CLI, sticky routing.
  • 0024 usage/function/async-invocation.md — async contract, retries (capped at 3), DLQ inspect/redrive, destinations.
  • 0025 versions-aliases.md + versions-lifecycle.md + canary over aliases.
  • 0026 usage/function/provisioned-concurrency.md (new) — base target, cron warming windows, observation, limits.
  • 0027 usage/triggers/statestore-eventing.md (new) — built-in topics, fission topic publish/peek, delivery semantics, error/response topics.
  • 0028 installation/upgrade.md — rollout posture, drain windows, warm-pod survival (procedure, no zero-downtime promise; gate not yet passing).
  • 0029 usage/spec/_index.md — idempotent apply, drift reconciliation, GitOps/CI section.
  • 0030 access-secret-cfgmap-in-function.en.md--env-var/--env-from-*, executor support matrix, explicit poolmgr limitation (RFC-0030 phase 2: per-function env/envFrom on the poolmgr executor (+ fission/environments runtime support) fission#3666).

Reference regen (from fission main)

  • CLI: 17 new command pages (alias group, versions/publish/rollback/state, environment impact) + flag updates.
  • CRD: Workflow/FunctionVersion/FunctionAlias added; terminationGracePeriod default corrected to 90s.
  • Metrics: rebuilt from source metric definitions (~60 missing metrics); page marked hand-maintained (no generator exists).

Freshness fixes on existing pages

  • async page: 5 verified errors (retry cap, invocation-id format, required statestore.mode, fn test --body handling, dlq purge flags).
  • OTEL: working collector walkthrough (current image, GOMEMLIMIT, OTLP→Jaeger native ingest).
  • auth pages: existingSecret, fail-closed startup, secretKeyRef correction.
  • streaming/MCP, OCI/Gateway API: verified corrections (image-volume default-on, dead defaultParentRef flow removed).

Wiring & checks

  • v1.28.0 highlights for 0026–0030, guide map, What's New card; sidebar truncation raised for the grown CLI reference; catalog entries for stateful/async/eventing examples.
  • STE + Tufte clarity sweep over all 30 touched pages with per-cluster meaning-preservation verification.
  • Pinned-Hugo production build clean, misspell clean, 0 broken internal links across 260 pages; both new mermaid diagrams browser-verified.

Merge ordering

Merge fission/examples#96 before or with this PR — the catalog and workflow-examples links point at miscellaneous/async-invocation and miscellaneous/eventing-topics on that branch.

…n, workflows)

Document three recently-merged, related features as one coherent series and
highlight them for the upcoming release: the statestore is the foundation;
asynchronous invocation and durable workflows are what you build on it.

New pages:
- architecture/statestore.md (RFC-0021) — KV + event log + queue substrate,
  embedded SQLite vs external Postgres, Helm config, consumers.
- usage/function/async-invocation.md (RFC-0024) — fire-and-forget contract,
  retries, dead-letter queue, result destinations, KEDA autoscaling.
- concepts/workflows.md (RFC-0022) — Workflow vs WorkflowRun, durability model.
- usage/workflows/ (RFC-0022) — overview, authoring reference, run-and-inspect,
  and the three worked examples.

Edits:
- Nav: architecture/concepts/usage index pages.
- releases/v1.28.0.md (draft: true) — three highlights, finalized at cut.
- Homepage "What's New" card (config.toml + _index.html, kept in sync).
- examples.json — three workflow examples in the Misc group.
- Regenerated fission-cli reference (workflow/dlq/topic + async flags).

Held as a draft until the release cut.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@netlify

netlify Bot commented Jul 19, 2026

Copy link
Copy Markdown

Deploy Preview for fission-website ready!

Name Link
🔨 Latest commit ba93cf9
🔍 Latest deploy log https://app.netlify.com/projects/fission-website/deploys/6a7762351fa6e600087be899
😎 Deploy Preview https://deploy-preview-314--fission-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

LanguageTool

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
The word ‘install’ is not a noun. (A_INSTALL[3])
Suggestions: installation
Rule: https://community.languagetool.org/rule/show/A_INSTALL?lang=en-US&subId=3
Category: GRAMMAR

All three headline features are **opt-in** and off by default, so a routine upgrade changes nothing for an existing install until you enable them.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

Send `X-Fission-Invoke-Mode: async` (or `fission fn test --async`) and the router enqueues the call, returns a durable invocation id with `202 Accepted`, and delivers it in the background with retries.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

* [Asynchronous invocation]({{% ref "function/async-invocation.md" %}}) — invoke a function fire-and-forget with a durable id, background retries, a dead-letter queue, and result destinations.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

Invoke a Fission function fire-and-forget — the router enqueues the call, returns a durable invocation id, and delivers it in the background with retries, a dead-letter queue, and result destinations.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

**Invoke a function fire-and-forget: the router accepts the call, returns a durable invocation id immediately, and delivers it in the background with retries — so the caller never waits for the work to finish.**


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

The router **enqueues** the call on the [statestore]({{% ref "/docs/architecture/statestore.md" %}}) queue, returns **`202 Accepted`** with a durable invocation id, and a background worker delivers it — retrying transient failures, dead-lettering what it cannot deliver, and optionally invoking a destination function with the result.


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

caller["Caller"]:::user -->|"<b>1.</b> request + X-Fission-Invoke-Mode: async"| router["Router"]:::fission


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

router -->|"<b>2.</b> enqueue"| queue["Statestore Queue"]:::store


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

router -->|"<b>3.</b> 202 + invocation id"| caller


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

router -->|"<b>3.</b> 202 + invocation id"| caller


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

queue -->|"<b>4.</b> dequeue"| worker["Async Worker"]:::fission


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

worker -->|"<b>5.</b> invoke"| pod["Function Pod"]:::pod


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

The CLI sends the async header and prints the durable invocation id instead of waiting for a response:


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

| `--id` | Operate on a single durable invocation id. |


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: validate
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: decision
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: charge
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short). (COMMA_COMPOUND_SENTENCE_2[1])
Suggestions: , so
URL: https://languagetool.org/insights/post/comma-before-and/
Rule: https://community.languagetool.org/rule/show/COMMA_COMPOUND_SENTENCE_2?lang=en-US&subId=1
Category: PUNCTUATION

The same applies to a caught error — merge it so the recovery step still sees the original input:


[LanguageTool] reported by reviewdog 🐶
The word ‘deploy’ is a verb. Did you mean the noun “deployment” (= release, placement)? (PREPOSITION_VERB[53])
Suggestions: deployment
URL: https://languagetool.org/insights/post/verbs-as-nouns/
Rule: https://community.languagetool.org/rule/show/PREPOSITION_VERB?lang=en-US&subId=53
Category: GRAMMAR

Each directory has the `workflow.yaml`, the functions it calls, and sample inputs, plus a README with the deploy steps.

title: "Workflows"
weight: 7
description: >
A durable state machine over functions — a Workflow definition and its WorkflowRun executions, recorded step by step in the statestore so a run survives restarts and resumes where it stopped.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short). (COMMA_COMPOUND_SENTENCE_2[1])
Suggestions: , so
URL: https://languagetool.org/insights/post/comma-before-and/
Rule: https://community.languagetool.org/rule/show/COMMA_COMPOUND_SENTENCE_2?lang=en-US&subId=1
Category: PUNCTUATION

### Options

```
-h, --help help for dlq

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

--limit int Maximum number of dead-lettered invocations to list (default 100)
-o, --output string -o |:|: Output format: wide, json or yaml (default: table)
--queue string Dead-letter queue to operate on: empty for async invocations, or an RFC-0027 broker egress queue (mq-egress-<type>, e.g. mq-egress-kafka)
-h, --help help for list

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


```
--queue string Dead-letter queue to operate on: empty for async invocations, or an RFC-0027 broker egress queue (mq-egress-<type>, e.g. mq-egress-kafka)
-h, --help help for purge

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

### Options

```
--id string Durable invocation id of a dead-lettered async invocation

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
The abbreviation for “identification” is spelled all-uppercase, or did you mean “I’d” (= I would/had)? (ID_CASING[1])
Suggestions: I'd, ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=1
Category: CASING

```
-A, --all-namespaces -A |:|: Fetch resources from all namespaces
-o, --output string -o |:|: Output format: wide, json or yaml (default: table)
-h, --help help for list

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

```
--name string Name of the workflow
--input string Run input as inline JSON, or @path/to/file.json
-h, --help help for run

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

### Options

```
-h, --help help for runs

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


```
--name string Name of the workflow run
-h, --help help for cancel

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


```
--name string Name of the workflow run
-h, --help help for describe

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

fulfil→fulfill, cancelling→canceling, labelled→labeled; soften the
graph-render claim now that the diagram uses the US spelling.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
```
--name string Name of the workflow run
--open Render the diagram in a browser (served locally; the graph never leaves your machine)
-h, --help help for graph

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

```
--name string Name of the workflow run
--io Include step input/output payloads (dereferences spilled documents)
-h, --help help for history

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

--workflow string Only show runs of this workflow
-A, --all-namespaces -A |:|: Fetch resources from all namespaces
-o, --output string -o |:|: Output format: wide, json or yaml (default: table)
-h, --help help for list

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

```
-f, --file string -f |:|: Path to a Workflow manifest (kind: Workflow) or a bare WorkflowSpec YAML
--name string Name of the workflow
-h, --help help for update

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

-f, --file string -f |:|: Path to a Workflow manifest (kind: Workflow) or a bare WorkflowSpec YAML
--name string Name of the workflow
--offline Skip cluster checks (e.g. referenced-function existence)
-h, --help help for validate

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

draft: false
weight: 50
description: >
Invoke a Fission function fire-and-forget — the router enqueues the call, returns a durable invocation id, and delivers it in the background with retries, a dead-letter queue, and result destinations.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

Invoke a Fission function fire-and-forget — the router enqueues the call, returns a durable invocation id, and delivers it in the background with retries, a dead-letter queue, and result destinations.
---

**Invoke a function fire-and-forget: the router accepts the call, returns a durable invocation id immediately, and delivers it in the background with retries — so the caller never waits for the work to finish.**

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING


**Three runnable workflows in the [examples repository](https://github.com/fission/examples/tree/main/miscellaneous/workflows) cover the full state-type palette.**

Each directory has the `workflow.yaml`, the functions it calls, and sample inputs, plus a README with the deploy steps.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
The word ‘deploy’ is a verb. Did you mean the noun “deployment” (= release, placement)? (PREPOSITION_VERB[53])
Suggestions: deployment
URL: https://languagetool.org/insights/post/verbs-as-nouns/
Rule: https://community.languagetool.org/rule/show/PREPOSITION_VERB?lang=en-US&subId=53
Category: GRAMMAR

A practical how-to for giving a function durable per-key state without an
external Redis/database: opt-in, the injected state URL + scoped token, and
worked patterns (per-user counter with compare-and-swap, session store with
TTL, shopping cart, rate limiter, AI agent conversation memory), plus sticky
routing for coherent in-memory caches, quotas/lifecycle, and the
fission fn state CLI. Cross-linked from the statestore architecture page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
fission function create --name cart --env nodejs --code cart.js --state
```

That is all a function needs. By default its keyspace is named after the function, values are capped at 256&nbsp;KiB, and it may hold up to 10,000 live keys. You can tune those:

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Did you mean: “By default,”? (BY_DEFAULT_COMMA[1])
Suggestions: By default,
Rule: https://community.languagetool.org/rule/show/BY_DEFAULT_COMMA?lang=en-US&subId=1
Category: PUNCTUATION

Add two usage pages for the new function versioning feature:

- versions-aliases.md: concepts (immutable versions, movable aliases),
  publishing, listing, alias-routed triggers (CLI and spec YAML),
  weighted splits, instant rollback (incl. the GitOps guard and
  --detach), and declarative/digest-pinned aliases.
- versions-lifecycle.md: automatic publishing (versioning.mode),
  retention GC, environment drift (EnvDrift, env impact), behavior of
  MQ/timer/watch/MCP/async/state/sticky paths through an alias, and
  canary rollouts over an alias.

Cross-link from the async (enqueue-time version pinning), canary
(alias mode recommended), and keyed-state (state shared across
versions) pages; add both pages to the usage guide map and the
v1.28.0 draft release notes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

LanguageTool

[LanguageTool] reported by reviewdog 🐶
Consider shortening this phrase to just ‘whether’, unless you mean ‘regardless of whether’. (WHETHER[7])
Suggestions: whether
URL: https://languagetool.org/insights/post/whether-vs-if/#when-to-use-%E2%80%9Cwhether%E2%80%9D
Rule: https://community.languagetool.org/rule/show/WHETHER?lang=en-US&subId=7
Category: REDUNDANCY

`fission fn publish` itself works on any function, whether or not `spec.versioning` is set.


[LanguageTool] reported by reviewdog 🐶
Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short). (COMMA_COMPOUND_SENTENCE_2[1])
Suggestions: , so
URL: https://languagetool.org/insights/post/comma-before-and/
Rule: https://community.languagetool.org/rule/show/COMMA_COMPOUND_SENTENCE_2?lang=en-US&subId=1
Category: PUNCTUATION

Version history is bounded per function so old snapshots do not accumulate forever:


[LanguageTool] reported by reviewdog 🐶
A comma is probably missing here. (MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1])
Suggestions: success,
URL: http://englishplus.com/grammar/00000074.htm
Rule: https://community.languagetool.org/rule/show/MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE?lang=en-US&subId=1
Category: PUNCTUATION

The canary controller then steps the alias's weight toward `orders-v4`, watching the error rate.


[LanguageTool] reported by reviewdog 🐶
A comma is probably missing here. (MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1])
Suggestions: failure,
URL: http://englishplus.com/grammar/00000074.htm
Rule: https://community.languagetool.org/rule/show/MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE?lang=en-US&subId=1
Category: PUNCTUATION

On success it promotes: the alias is repointed fully at the new version.

sanketsudake and others added 19 commits July 25, 2026 21:28
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Cross-checked the versions/aliases pages against the RFC-0025
implementation (fission 651ac3bf): flags, error strings, and
transcript output already matched. Added the two gaps found — a
`fn test --alias` rollback-verification transcript, and an imperative
`--package-digest` example alongside the existing YAML digest-pin
example.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Fission renamed the `fn create/update` version-retention flag from
--retain to --retain-versions to disambiguate it from the pre-existing
--retainpods pod-warming knob. Update the transcript and prose in
versions-lifecycle.md; the versioning.retain spec field is unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
CLI: adds alias, function versions/publish/rollback/gc-versions/state,
environment impact pages; picks up --provisioned-concurrency,
--provisioned-schedule, --env-var, --env-from-secret, --env-from-configmap.
CRD: adds Workflow, FunctionVersion, FunctionAlias; terminationGracePeriod
default corrected to 90s.
- helm snippet: statestore.mode is required when statestore.enabled
- retry attempts capped at 3 (MaxAsyncAttempts), example used 5
- real fn test --async output format and asyncinv/<hex> id format
- router 202 returns header + JSON body with invocationId
- fn test --body does not expand @file; use inline JSON
- dlq purge takes no --all flag; note redrive resets attempts
Stateful counter/session (merged fission/examples#95) plus the new
async-invocation and eventing-topics examples on the
examples/async-and-eventing branch.
Adds ~60 missing metrics (router hot-path, async invocation, eventing,
statestore, provisioned concurrency, workflows). Marks the page as
hand-maintained in the authoring resources — no generator exists.
W3C-only propagators, metricsExporter values, describe VERSIONING
output, run-local --secret-mount/--configmap-mount flags.
internal-auth: existingSecret/autoGenerate, fail-closed startup check,
namespace replication, uninstall retention. authentication: secretKeyRef
correction, existingSecret value, GitOps note.
Idle-timeout is a router env var not a chart value; fission function
tools real output columns; /mcp endpoint details.
Image-volume delivery is default-on (auto-gated below K8s 1.33);
drop the dead defaultParentRef flow — the CRD CEL rule requires
explicit parentRefs.
Sentence-splitting to ASD-STE100 caps, active voice, filler removal,
one-sentence-per-line formatting across the 30 branch-touched pages.
Verified per cluster: no command, flag, value, caveat, or link target
changed; two meaning-drift edits caught and restored in verification.
Replace the 0.6.0 image, removed --mem-ballast-size-mib flag, and
dead jaeger exporter with collector 0.158.0, GOMEMLIMIT, and an
otlp/jaeger exporter to Jaeger's native OTLP ingest; health_check
bound to pod IP; memory_limiter+batch processors added.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

LanguageTool

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: wait
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

--wait Wait for the function's referenced package build to finish before publishing (see --timeout)


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: wait
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

--wait Wait for the alias to resolve to the rollback target (see --timeout)


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: keep
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

--keep Keep the local function container and mount running after the invocation instead of tearing it down


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Secrets, secrets
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING

--secret-mount stringArray Mount a secret at a path relative to /secrets, matching the function's spec.secrets[].mountPath in-cluster. Format NAME=PATH, e.g. --secret-mount db-creds=app/creds. Repeatable. Without this a secret lands at the default /secrets/<namespace>/<name>.


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

--async Invoke asynchronously (X-Fission-Invoke-Mode: async); prints the invocation id instead of waiting for the response. Set FISSION_INTERNAL_AUTH_SECRET when authentication is enabled.


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
The singular proper name ‘Force’ must be used with a third-person or a past tense verb. (HE_VERB_AGR[5])
Suggestions: updates, updated
Rule: https://community.languagetool.org/rule/show/HE_VERB_AGR?lang=en-US&subId=5
Category: GRAMMAR

-f, --force -f |:|: Force update a package even if it is used by one or more functions


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

--invocation-mode string 'async' makes every request through this trigger asynchronous (durable 202 + invocation id); empty is the default synchronous mode


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

--invocation-mode string 'async' makes every request through this trigger asynchronous (durable 202 + invocation id); empty is the default synchronous mode


[LanguageTool] reported by reviewdog 🐶
The word ‘install’ is not a noun. (A_INSTALL[3])
Suggestions: installation
Rule: https://community.languagetool.org/rule/show/A_INSTALL?lang=en-US&subId=3
Category: GRAMMAR

All headline features are **opt-in** and off by default, so a routine upgrade changes nothing for an existing install until you enable them.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

It returns a durable invocation id with `202 Accepted` and delivers the call in the background with retries.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

* [Asynchronous invocation]({{% ref "function/async-invocation.md" %}}) — invoke a function fire-and-forget with a durable id, background retries, a dead-letter queue, and result destinations.


[LanguageTool] reported by reviewdog 🐶
Did you mean: “By default,”? (BY_DEFAULT_COMMA[1])
Suggestions: By default,
Rule: https://community.languagetool.org/rule/show/BY_DEFAULT_COMMA?lang=en-US&subId=1
Category: PUNCTUATION


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Environ, environ
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING

"DATABASE_URL=%s" % os.environ["DATABASE_URL"],


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Environ, environ
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING

"DB_PASSWORD=%s" % os.environ["DB_PASSWORD"],


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Environ, environ
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Environ, environ
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING


[LanguageTool] reported by reviewdog 🐶
The word ‘create’ is a verb. Did you mean the noun “creation”? (PREPOSITION_VERB[78])
Suggestions: creation
URL: https://languagetool.org/insights/post/verbs-as-nouns/
Rule: https://community.languagetool.org/rule/show/PREPOSITION_VERB?lang=en-US&subId=78
Category: GRAMMAR

Without `--executortype newdeploy`, the create is rejected, because the default executor is poolmgr:


[LanguageTool] reported by reviewdog 🐶
Specify a number, remove phrase, or simply use “many” or “numerous” (LARGE_NUMBER_OF[1])
Suggestions: many, numerous
URL: https://languagetool.org/insights/post/wordiness/
Rule: https://community.languagetool.org/rule/show/LARGE_NUMBER_OF?lang=en-US&subId=1
Category: REDUNDANCY

If a large number of functions use the same ConfigMap or Secret, updating it re-creates a large number of pods at once.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

The router **enqueues** the call on the [statestore]({{% ref "/docs/architecture/statestore.md" %}}) queue and returns **`202 Accepted`** with a durable invocation id.


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

caller["Caller"]:::user -->|"<b>1.</b> request + X-Fission-Invoke-Mode: async"| router["Router"]:::fission


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

router -->|"<b>2.</b> enqueue"| queue["Statestore Queue"]:::store


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

router -->|"<b>3.</b> 202 + invocation id"| caller


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

router -->|"<b>3.</b> 202 + invocation id"| caller


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

queue -->|"<b>4.</b> dequeue"| worker["Async Worker"]:::fission


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

worker -->|"<b>5.</b> invoke"| pod["Function Pod"]:::pod


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

The CLI sends the async header and prints the durable invocation id instead of waiting for a response:


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

| `--id` | Operate on a single durable invocation id (`show`, `redrive`). |


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

`fission function test` attributes a failure to a component and hands you a request id.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

Every run echoes the invocation's request id.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

You also have the request id to find its logs.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

Every response — success or failure — carries the request id.


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

req["Request"]:::user -->|"<b>1.</b> HTTP"| pod["Function Pod<br/>(your code)"]:::pod


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: pod
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

req["Request"]:::user -->|"<b>1.</b> HTTP"| pod["Function Pod<br/>(your code)"]:::pod


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

pod -->|"<b>2.</b> get / set / cas<br/>Bearer token"| svc["State API"]:::fission


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

svc -->|"<b>3.</b> scoped to<br/>this function's keyspace"| store["Statestore"]:::store


[LanguageTool] reported by reviewdog 🐶
The official spelling of this programming framework is “Node.js”. (NODE_JS[3])
Suggestions: Node.js
Rule: https://community.languagetool.org/rule/show/NODE_JS?lang=en-US&subId=3
Category: COMPOUNDING

fission function create --name cart --env nodejs --code cart.js --state


[LanguageTool] reported by reviewdog 🐶
Did you mean: “By default,”? (BY_DEFAULT_COMMA[1])
Suggestions: By default,
Rule: https://community.languagetool.org/rule/show/BY_DEFAULT_COMMA?lang=en-US&subId=1
Category: PUNCTUATION

That is all a function needs.


[LanguageTool] reported by reviewdog 🐶
The official spelling of this programming framework is “Node.js”. (NODE_JS[3])
Suggestions: Node.js
Rule: https://community.languagetool.org/rule/show/NODE_JS?lang=en-US&subId=3
Category: COMPOUNDING

fission function create --name sessions --env nodejs --code sessions.js \


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Environ, environ
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Status, status
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING

return resp.status, resp.read(), resp.headers


[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Headers, headers
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING

return resp.status, resp.read(), resp.headers


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

s, b, hdr = req("GET", f"/v1/state/{key}")


[LanguageTool] reported by reviewdog 🐶
Did you mean “is”? (IF_IS[1])
Suggestions: is
Rule: https://community.languagetool.org/rule/show/IF_IS?lang=en-US&subId=1
Category: TYPOS

extra = {"If-Match": str(if_version)} if if_version is not None else None


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

s, _, _ = req("PUT", f"/v1/state/{key}", value.encode(), extra)


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

req("DELETE", f"/v1/state/{key}")


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

The simplest useful pattern: increment a value keyed by user id.


[LanguageTool] reported by reviewdog 🐶
The verb ‘write’ does not usually follow articles like ‘The’. Check that ‘write’ is spelled correctly; using ‘write’ as a noun may be non-standard. (A_INFINITIVE[2])
Suggestions: To write, The White, The trite, The white, The writ, They write
URL: https://languagetool.org/insights/post/verbs-as-nouns/
Rule: https://community.languagetool.org/rule/show/A_INFINITIVE?lang=en-US&subId=2
Category: GRAMMAR

Use the version returned by `get` as a **compare-and-swap** token on the `set`.


[LanguageTool] reported by reviewdog 🐶
It appears that a white space is missing. (SPACE_BEFORE_PARENTHESIS[1])
Suggestions: (
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/SPACE_BEFORE_PARENTHESIS?lang=en-US&subId=1
Category: TYPOGRAPHY

const code = await state.set(user, String(next), { ifVersion: cur ? cur.version : 0 });


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

Store a session document keyed by session id, with a TTL so it expires on its own:


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

A cart is a value keyed by cart id.


[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

Give an agent function a durable memory keyed by conversation id.


[LanguageTool] reported by reviewdog 🐶
The official spelling of this programming framework is “Node.js”. (NODE_JS[3])
Suggestions: Node.js
Rule: https://community.languagetool.org/rule/show/NODE_JS?lang=en-US&subId=3
Category: COMPOUNDING

fission function create --name game-room --env nodejs --code room.js --state \


[LanguageTool] reported by reviewdog 🐶
The word ‘install’ is not a noun. (A_INSTALL[1])
Suggestions: installation
Rule: https://community.languagetool.org/rule/show/A_INSTALL?lang=en-US&subId=1
Category: GRAMMAR

By default that is the function's own namespace.


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

spec["Function spec:<br/>target + windows"]:::user -->|"<b>1.</b> effective target = base, or active window"| prov["Provisioner (Executor)"]:::fission


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

prov -->|"<b>2.</b> below target: specialize eagerly"| pool["Generic pool pod"]:::pod


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

pool -->|"<b>3.</b> label fission.io/provisioned"| warm["Warm specialized pod"]:::pod


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

prov -.->|"<b>4.</b> above target: clear label"| warm


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

reaper["Idle reaper"]:::fission -.->|"<b>5.</b> retires unlabeled idle pods"| warm


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘'’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

$ kubectl get function checkout -o jsonpath='{.status.provisionedReady}/{.status.provisionedTarget}{"\n"}'


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

-o jsonpath='{.status.conditions[?(@.type=="Provisioned")].reason}{"\n"}'


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘'’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

-o jsonpath='{.status.conditions[?(@.type=="Provisioned")].reason}{"\n"}'


[LanguageTool] reported by reviewdog 🐶
Uncountable nouns are usually not used with an indefinite article. Use simply “weighted traffic”. (A_UNCOUNTABLE[3])
Suggestions: weighted traffic
URL: https://languagetool.org/insights/post/grammar-countable-uncountable-nouns/
Rule: https://community.languagetool.org/rule/show/A_UNCOUNTABLE?lang=en-US&subId=3
Category: GRAMMAR

- An **alias** (`FunctionAlias`, `kubectl get fnalias`) is a movable, named pointer at one version — or at two versions during a weighted traffic split.


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: Resolved
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

Resolved True Resolved resolved to FunctionVersion "orders-v4" 8s


[LanguageTool] reported by reviewdog 🐶
It seems like there are too many consecutive spaces here. (CONSECUTIVE_SPACES[1])
Suggestions:
Rule: https://community.languagetool.org/rule/show/CONSECUTIVE_SPACES?lang=en-US&subId=1
Category: TYPOGRAPHY

Resolved True Resolved resolved to FunctionVersion "orders-v4" 8s


[LanguageTool] reported by reviewdog 🐶
Possible agreement error. The noun ‘version’ seems to be countable. (CD_NN[1])
Suggestions: versions
Rule: https://community.languagetool.org/rule/show/CD_NN?lang=en-US&subId=1
Category: GRAMMAR

EnvDrift False EnvCurrent environment default/node generation 5 matches version "orders-v4"'s recorded generation 5 8s


[LanguageTool] reported by reviewdog 🐶
The plural noun “lives” cannot be used with the article “An”. Did you mean “An alias life” or “alias lives”? (A_NNS[3])
Suggestions: An alias life, Alias lives
Rule: https://community.languagetool.org/rule/show/A_NNS?lang=en-US&subId=3
Category: GRAMMAR

`fission alias delete --name prod` removes the alias.


[LanguageTool] reported by reviewdog 🐶
It seems like there are too many consecutive spaces here. (CONSECUTIVE_SPACES[1])
Suggestions:
Rule: https://community.languagetool.org/rule/show/CONSECUTIVE_SPACES?lang=en-US&subId=1
Category: TYPOGRAPHY

NAME NAMESPACE READY STATUS IP EXECUTORTYPE MANAGED SERVED VERSION


[LanguageTool] reported by reviewdog 🐶
It seems like there are too many consecutive spaces here. (CONSECUTIVE_SPACES[1])
Suggestions:
Rule: https://community.languagetool.org/rule/show/CONSECUTIVE_SPACES?lang=en-US&subId=1
Category: TYPOGRAPHY

poolmgr-node-default-8750-844bd45565-9tvrj default 2/2 Running 10.244.0.77 poolmgr false true orders-v4


[LanguageTool] reported by reviewdog 🐶
It seems like there are too many consecutive spaces here. (CONSECUTIVE_SPACES[1])
Suggestions:
Rule: https://community.languagetool.org/rule/show/CONSECUTIVE_SPACES?lang=en-US&subId=1
Category: TYPOGRAPHY

poolmgr-node-default-8750-844bd45565-pg8rk default 2/2 Running 10.244.0.78 poolmgr false true orders-v3


[LanguageTool] reported by reviewdog 🐶
It seems like there are too many consecutive spaces here. (CONSECUTIVE_SPACES[1])
Suggestions:
Rule: https://community.languagetool.org/rule/show/CONSECUTIVE_SPACES?lang=en-US&subId=1
Category: TYPOGRAPHY

NAME NAMESPACE READY STATUS IP EXECUTORTYPE MANAGED SERVED VERSION


[LanguageTool] reported by reviewdog 🐶
It seems like there are too many consecutive spaces here. (CONSECUTIVE_SPACES[1])
Suggestions:
Rule: https://community.languagetool.org/rule/show/CONSECUTIVE_SPACES?lang=en-US&subId=1
Category: TYPOGRAPHY

poolmgr-node-default-8750-844bd45565-pg8rk default 2/2 Running 10.244.0.78 poolmgr false true orders-v3


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: name
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: name
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: name
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
The word ‘deploy’ is a verb. Did you mean the noun “deployment” (= release, placement)? (PREPOSITION_VERB[53])
Suggestions: deployment
URL: https://languagetool.org/insights/post/verbs-as-nouns/
Rule: https://community.languagetool.org/rule/show/PREPOSITION_VERB?lang=en-US&subId=53
Category: GRAMMAR


[LanguageTool] reported by reviewdog 🐶
Possible subject-verb agreement error. (SINGULAR_NOUN_ADV_AGREEMENT[1])
Suggestions: updates, updated
Rule: https://community.languagetool.org/rule/show/SINGULAR_NOUN_ADV_AGREEMENT?lang=en-US&subId=1
Category: GRAMMAR


[LanguageTool] reported by reviewdog 🐶
Did you mean: “By default,”? (BY_DEFAULT_COMMA[1])
Suggestions: By default,
Rule: https://community.languagetool.org/rule/show/BY_DEFAULT_COMMA?lang=en-US&subId=1
Category: PUNCTUATION

$ fission fn test --name orders --alias prod


[LanguageTool] reported by reviewdog 🐶
In American English, ‘afterward’ is the preferred variant. ‘Afterwards’ is more commonly used in British English and other dialects. (AFTERWARDS_US[1])
Suggestions: afterward
Rule: https://community.languagetool.org/rule/show/AFTERWARDS_US?lang=en-US&subId=1
Category: BRITISH_ENGLISH

- **Emergency:** re-run with `--detach`, which strips the spec-ownership annotations in the same update as the repoint, so a later `spec apply` no longer reverts it.


[LanguageTool] reported by reviewdog 🐶
Consider shortening this phrase to just ‘whether’, unless you mean ‘regardless of whether’. (WHETHER[7])
Suggestions: whether
URL: https://languagetool.org/insights/post/whether-vs-if/#when-to-use-%E2%80%9Cwhether%E2%80%9D
Rule: https://community.languagetool.org/rule/show/WHETHER?lang=en-US&subId=7
Category: REDUNDANCY

`fission fn publish` itself works on any function, whether or not `spec.versioning` is set.


[LanguageTool] reported by reviewdog 🐶
Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short). (COMMA_COMPOUND_SENTENCE_2[1])
Suggestions: , so
URL: https://languagetool.org/insights/post/comma-before-and/
Rule: https://community.languagetool.org/rule/show/COMMA_COMPOUND_SENTENCE_2?lang=en-US&subId=1
Category: PUNCTUATION

Version history is bounded per function so old snapshots do not accumulate forever:


[LanguageTool] reported by reviewdog 🐶
A comma is probably missing here. (MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1])
Suggestions: success,
URL: http://englishplus.com/grammar/00000074.htm
Rule: https://community.languagetool.org/rule/show/MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE?lang=en-US&subId=1
Category: PUNCTUATION

The canary controller then steps the alias's weight toward `orders-v4`, watching the error rate.


[LanguageTool] reported by reviewdog 🐶
A comma is probably missing here. (MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE[1])
Suggestions: failure,
URL: http://englishplus.com/grammar/00000074.htm
Rule: https://community.languagetool.org/rule/show/MISSING_COMMA_AFTER_INTRODUCTORY_PHRASE?lang=en-US&subId=1
Category: PUNCTUATION

On success it promotes: the alias is repointed fully at the new version.


[LanguageTool] reported by reviewdog 🐶
Possible typo detected. (NUMBERS_IN_WORDS[1])
Suggestions: multi
Rule: https://community.languagetool.org/rule/show/NUMBERS_IN_WORDS?lang=en-US&subId=1
Category: TYPOS

Fission does not honor other propagator types (`b3`, `b3multi`, `jaeger`, `xray`, `ottrace`).


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: archive
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

would upload archive archive://eval-xk2p


[LanguageTool] reported by reviewdog 🐶
Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short). (COMMA_COMPOUND_SENTENCE_2[1])
Suggestions: , so
URL: https://languagetool.org/insights/post/comma-before-and/
Rule: https://community.languagetool.org/rule/show/COMMA_COMPOUND_SENTENCE_2?lang=en-US&subId=1
Category: PUNCTUATION

We create two Python functions, each in its own directory with an empty `requirements.txt` file so the builder can build the code.


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: archive
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

With `--wait`, the command waits for the builds of both functions to complete before exiting:


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: archive
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

To deploy the change, apply the specs again:


[LanguageTool] reported by reviewdog 🐶
An apostrophe may be missing. (POSSESSIVE_APOSTROPHE[1])
Suggestions: specs', spec's
URL: https://languagetool.org/insights/post/possessive-apostrophe/
Rule: https://community.languagetool.org/rule/show/POSSESSIVE_APOSTROPHE?lang=en-US&subId=1
Category: TYPOS

You can see these custom resources with `kubectl`: try `kubectl get customresourcedefinitions` or `kubectl get function.fission.io`.


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

pub -->|"<b>1.</b> append"| stream["Topic Stream"]:::store


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

stream -->|"<b>2.</b> read from cursor"| mqt["Statestore MQ Consumer"]:::fission


[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

mqt -->|"<b>3.</b> invoke via router"| pod["Function Pod"]:::pod


[LanguageTool] reported by reviewdog 🐶
File types are normally capitalized. (FILE_EXTENSIONS_CASE[1])
Suggestions: JS
URL: https://languagetool.org/insights/post/spelling-capital-letters/
Rule: https://community.languagetool.org/rule/show/FILE_EXTENSIONS_CASE?lang=en-US&subId=1
Category: CASING


[LanguageTool] reported by reviewdog 🐶
A determiner may be missing. (THE_SUPERLATIVE[5])
Suggestions: , the best
URL: https://languagetool.org/insights/post/grammar-comparatives-superlatives/#superlative-forms-of-adjectives
Rule: https://community.languagetool.org/rule/show/THE_SUPERLATIVE?lang=en-US&subId=5
Category: GRAMMAR

| Response topic | The 2xx response body is published to `--resptopic`, best effort. |


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: validate
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: decision
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: charge
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


[LanguageTool] reported by reviewdog 🐶
Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short). (COMMA_COMPOUND_SENTENCE_2[1])
Suggestions: , so
URL: https://languagetool.org/insights/post/comma-before-and/
Rule: https://community.languagetool.org/rule/show/COMMA_COMPOUND_SENTENCE_2?lang=en-US&subId=1
Category: PUNCTUATION

The same applies to a caught error — merge it so the recovery step still sees the original input:

evt --> log
evt --> queue
kv --> driver
log --> driver

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: driver
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


## Related

- [Durable Workflows]({{% ref "/docs/usage/workflows/_index.md" %}}) — multi-step orchestration recorded in the event log.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
This word is normally spelled as one. (EN_COMPOUNDS_MULTI_STEP)
Suggestions: multistep
Rule: https://community.languagetool.org/rule/show/EN_COMPOUNDS_MULTI_STEP?lang=en-US
Category: MISC

jwtSigningKey:

## existingSecret names a pre-created Secret in the release namespace
## with the keys username, password, and jwtSigningKey.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
An apostrophe may be missing. (POSSESSIVE_APOSTROPHE[2])
Suggestions: keys', key's
URL: https://languagetool.org/insights/post/possessive-apostrophe/
Rule: https://community.languagetool.org/rule/show/POSSESSIVE_APOSTROPHE?lang=en-US&subId=2
Category: TYPOS


```bash
kubectl create secret generic fission-auth-master -n fission \
--from-literal=secret="$(openssl rand -base64 32)"

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

This is the recommended path for GitOps renderers (Argo CD, Flux).
Those run `helm template`, where the chart cannot preserve a generated value across syncs.
Each sync would mint a new master and break every running pod.
Switching an existing install to `existingSecret` is safe: a pre-upgrade hook marks the chart-generated Secret with `helm.sh/resource-policy=keep`, so Helm does not prune it.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
The word ‘install’ is not a noun. (A_INSTALL[3])
Suggestions: installation
Rule: https://community.languagetool.org/rule/show/A_INSTALL?lang=en-US&subId=3
Category: GRAMMAR

--targetcpu int Target average CPU usage percentage across pods for scaling (default 80)
--spec Save to the spec directory instead of creating on cluster
--dry View the generated specs
-h, --help help for create

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

-h, --help help for describe
--name string Function name
--version string Describe a specific pinned FunctionVersion's snapshot instead of the live function
-h, --help help for describe

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

```
--name string Function name
--keep int Override the retain count for this sweep (default: the function's Spec.Versioning.Retain, or 10)
-h, --help help for gc-versions

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

-h, --help help for get
--name string Function name
--version string Get a specific pinned FunctionVersion's snapshot source instead of the live function
-h, --help help for get

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

--name string Function name
--alias string List only pods for a specific alias's (e.g. prod) resolved version; mutually exclusive with --version
--version string List only pods for a specific pinned FunctionVersion; mutually exclusive with --alias
-h, --help help for pods

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: help
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

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.

1 participant