Skip to content

docs: deprecate processed_tags in file incremental processing#378

Draft
jirkasemmler wants to merge 2 commits into
mainfrom
jirka/deprecate-processed-tags
Draft

docs: deprecate processed_tags in file incremental processing#378
jirkasemmler wants to merge 2 commits into
mainfrom
jirka/deprecate-processed-tags

Conversation

@jirkasemmler
Copy link
Copy Markdown
Contributor

Jira issue(s): n/a (driven by INC-00973)

The processed_tags setting in file input mapping is being deprecated. It is fundamentally incompatible with the development-branches feature (a job running in a dev branch cannot write tags back to files in production storage), which caused INC-00973 during the rollout on 20 May 2026.

After investigation we decided to deprecate the option rather than complete its dev-branch support — adoption is narrow (~253 actively used configurations) and viable alternatives exist for all known use cases. UI removal of the option ships separately.

Changes:

  • Add a deprecation notice at the top of the Incremental processing section under Files.
  • Keep the existing processed_tags example for users with legacy configurations.
  • Add an Alternatives to processed_tags subsection covering: incremental Storage tables, time-bounded queries, the component state file, and explicit file_ids.

Companion PR in connection-docs: keboola/connection-docs#930

cc @hhanova for proofreading.

processed_tags is incompatible with the development-branches feature.
Mark the setting as deprecated and document recommended alternatives.

Refs INC-00973.
…as deprecated

Reorder so recommended alternatives come first and the original processed_tags
description is demoted to a clearly-labeled legacy reference subsection in past tense.

Addresses PR review feedback.
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