Document dataclass field should not be reused

Documentation

The current implementation of dataclass modifies a field in place. Thereby, the following code will modify f:

from dataclasses import dataclass, field

f = field(kw_only=True)

@dataclass
class A:
    x: int = f
    y: int = f

print(f) # now f.name is filled
# furthermore, A is broken (or does not behave if we used two different field instance)

It can create issues when we have multiple fields that have the same spec and we reuse the same Field instance to set the same metadata to all of them. A class is created but it's garbage.

IMHO, in the docs, we should warn the user to NOT share any Field instance.

Linked PRs

• gh-145373
• gh-145387

Bắt đầu bằng việc xem lại tài liệu về dataclass và Field cùng các PR được liên kết gh-145373 và gh-145387. Thêm cảnh báo rõ ràng không được tái sử dụng một thực thể Field giữa các trường dataclass, và coi ví dụ trong issue là hoàn tất khi hướng dẫn được ghi trong tài liệu đề cập đến sự biến đổi phát sinh và hành vi bị hỏng của lớp.