reactjs / reactjs/react.dev

How to understand the word "taint" in the new APIs taintObjectReference and taintUniqueValue?

Open
#6,343 9 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
11.8k
Forks
7.9k
Avg merge
1d 11h
Merged PRs (30d)
11

Description

When I'm translating the docs reference/react/experimental_taintObjectReference and reference/react/experimental_taintUniqueValue into Chinese, I'm thinking the deep meaning of the word "taint".
The explanation of the "taint" is to damage or spoil the quality, or the effect of something bad or unpleasant that spoils the quality, which carries a somewhat negative connotation. However, considering the documentations' description of the APIs, it's difficult to detect any negative sentiment. In terms of meaning, it appears that "taint" simply signifies the marking of something with some special behavior.
I understand that Kubernetes has related concepts regarding "taint", but I feel that these two cannot be directly equated. I would like to know how React describes the meaning of "taint"?
Thanks a lot.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the referenced documentation pages: reference/react/experimental_taintObjectReference and reference/react/experimental_taintUniqueValue. Read the existing issue comments to understand whether the terminology has been resolved and what wording is agreed on. Done means documenting a clear explanation of “taint” for translators, if a concrete documentation change is identified.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, react
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.