## Change Summary

Minor docs update motivated by the following:
* #7833
* #7869
* #7842

## Related issue number

Fix #7833
Fix #7869
Fix #7842

* [x] The pull request title is a good summary of the changes - it will be used in the changelog
* [ ] Unit tests for the changes exist
* [x] Tests pass on CI
* [x] Documentation reflects the changes where applicable
* [x] My PR is ready to review, **please add a comment including the phrase "please review" to assign reviewers**


Selected Reviewer: @lig
Minor docs update. ## Change Summary

Minor docs update motivated by the following:
* #7833
* #7869
* #7842

## Related issue number

Fix #7833
Fix #7869
Fix #7842

* [x] The pull request title is a good summary of the changes - it will be used in the changelog
* [ ] Unit tests for the changes exist
* [x] Tests pass on CI
* [x] Documentation reflects the changes where applicable
* [x] My PR is ready to review, **please add a comment including the phrase "please review" to assign reviewers**


Selected Reviewer: @lig
from pydantic import BaseModel, computed_field


class Square(BaseModel):
    side: float

    @computed_field
# MYPY: error: Decorators on top of @property are not supported  [misc]
    @property
    def area(self) -> float:
        return self.side**2

    @area.setter
    def area(self, area: float) -> None:
        self.side = area**0.5


sq = Square(side=10)
y = 12.4 + sq.area
z = 'x' + sq.area
# MYPY: error: Unsupported operand types for + ("str" and "float")  [operator]

try:
    from functools import cached_property
except ImportError:
    pass
else:

    class Square2(BaseModel):
        side: float

        @computed_field
# MYPY: error: Decorators on top of @property are not supported  [misc]
        @cached_property
        def area(self) -> float:
            return self.side**2

    sq = Square(side=10)
    y = 12.4 + sq.area
    z = 'x' + sq.area
# MYPY: error: Unsupported operand types for + ("str" and "float")  [operator]

from pydantic import BaseModel, computed_field


class Square(BaseModel):
    side: float

    @computed_field
# MYPY: error: Decorators on top of @property are not supported  [misc]
    @property
    def area(self) -> float:
        return self.side**2

    @area.setter
    def area(self, area: float) -> None:
        self.side = area**0.5


sq = Square(side=10)
y = 12.4 + sq.area
z = 'x' + sq.area
# MYPY: error: Unsupported operand types for + ("str" and "float")  [operator]

try:
    from functools import cached_property
except ImportError:
    pass
else:

    class Square2(BaseModel):
        side: float

        @computed_field
# MYPY: error: Decorators on top of @property are not supported  [misc]
        @cached_property
        def area(self) -> float:
            return self.side**2

    sq = Square(side=10)
    y = 12.4 + sq.area
    z = 'x' + sq.area
# MYPY: error: Unsupported operand types for + ("str" and "float")  [operator]
