Skip to content

Additional docs for JobArgs.Kind#892

Merged
brandur merged 1 commit into
masterfrom
brandur-job-kind-docs
May 11, 2025
Merged

Additional docs for JobArgs.Kind#892
brandur merged 1 commit into
masterfrom
brandur-job-kind-docs

Conversation

@brandur

@brandur brandur commented May 10, 2025

Copy link
Copy Markdown
Contributor

Follow up #879 to add a little more useful context to JobArgs.Kind:

  • Explain why Kind is a string rather than based on type names.
  • Mention that special characters like spaces and commas are not
    allowed. Suggest examples on what is allowed.
  • Mention how changing a kind generally isn't safe unless the database
    is completely empty and that JobArgsWithKindAliases can be used to
    rename jobs safely.

Follow up #879 to add a little more useful context to `JobArgs.Kind`:

* Explain why `Kind` is a string rather than based on type names.
* Mention that special characters like spaces and commas are not
  allowed. Suggest examples on what _is_ allowed.
* Mention how changing a kind generally isn't safe unless the database
  is completely empty and that `JobArgsWithKindAliases` can be used to
  rename jobs safely.
@brandur brandur requested a review from bgentry May 10, 2025 21:14

@bgentry bgentry 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.

Great additions.

@brandur

brandur commented May 11, 2025

Copy link
Copy Markdown
Contributor Author

ty ty.

@brandur brandur merged commit 056d372 into master May 11, 2025
10 checks passed
@brandur brandur deleted the brandur-job-kind-docs branch May 11, 2025 00:30
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