Skip to content

docs(STRINGS-3095): Warn that job tags match all keys carrying the tag - #1257

Merged
Łukasz Ciesielski (lookasc) merged 1 commit into
mainfrom
docs/strings-3095-tags-collision-warning
Sep 9, 2026
Merged

docs(STRINGS-3095): Warn that job tags match all keys carrying the tag#1257
Łukasz Ciesielski (lookasc) merged 1 commit into
mainfrom
docs/strings-3095-tags-collision-warning

Conversation

@lookasc

@lookasc Łukasz Ciesielski (lookasc) commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Related ticket: https://phrase.atlassian.net/browse/STRINGS-3095

Purpose

  • The create-job tags field was documented without warning that a shared tag matches every key already carrying it, which let a caller unintentionally pull dozens of unrelated pre-existing keys into a job.
  • Added a caution note to the field description telling callers that a tag matches all keys currently carrying it, and to use translation_key_ids when they need to scope a job to specific keys.
  • Docs-only change; no API behavior is affected.

Add a caution note to the create-job `tags` field so callers know a
shared tag pulls in every key already carrying it, and to use
`translation_key_ids` to scope to specific keys.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

API changelog (oasdiff)

Doc-only edits (descriptions, examples) do not appear here.

No changes to report, but the specs are different.
Run 'oasdiff diff' to see structural differences.

@lookasc
Łukasz Ciesielski (lookasc) merged commit 9a63777 into main Sep 9, 2026
14 checks passed
@lookasc
Łukasz Ciesielski (lookasc) deleted the docs/strings-3095-tags-collision-warning branch September 9, 2026 07:40
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