## Change Summary

* #7811 - make sure specification for `__pydantic_fields_set__`, `model_fields_set`, and `exclude_unset` is consistent (in docstrings + docs)
* #7588 - adding explanation for changes to `model_rebuild` vs `update_forward_refs` to migration guide

## Related issue number

Fix #7811
Fix #7588

## Checklist

* [x] The pull request title is a good summary of the changes - it will be used in the changelog
* [x] Unit tests for the changes exist
* [ ] 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: @dmontagu
Docs update: keeping model_fields_set defs consistent and adding explanation for model_rebuild changes. ## Change Summary

* #7811 - make sure specification for `__pydantic_fields_set__`, `model_fields_set`, and `exclude_unset` is consistent (in docstrings + docs)
* #7588 - adding explanation for changes to `model_rebuild` vs `update_forward_refs` to migration guide

## Related issue number

Fix #7811
Fix #7588

## Checklist

* [x] The pull request title is a good summary of the changes - it will be used in the changelog
* [x] Unit tests for the changes exist
* [ ] 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: @dmontagu
Installation is as simple as:

```bash
pip install pydantic
```

Pydantic has a few dependencies:

* [`pydantic-core`](https://pypi.org/project/pydantic-core/): Core validation logic for _pydantic_ written in rust.
* [`typing-extensions`](https://pypi.org/project/typing-extensions/): Backport of the standard library `typing` module.
* [`annotated-types`](https://pypi.org/project/annotated-types/): Reusable constraint types to use with `typing.Annotated`.

If you've got Python 3.7+ and `pip` installed, you're good to go.

Pydantic is also available on [conda](https://www.anaconda.com) under the [conda-forge](https://conda-forge.org)
channel:

```bash
conda install pydantic -c conda-forge
```

## Optional dependencies

Pydantic has the following optional dependencies:

* If you require email validation, you can add [email-validator](https://github.com/JoshData/python-email-validator).

To install optional dependencies along with Pydantic:

```bash
pip install pydantic[email]
```

Of course, you can also install requirements manually with `pip install email-validator`.

## Install from repository

And if you prefer to install Pydantic directly from the repository:

```bash
pip install git+https://github.com/pydantic/pydantic@main#egg=pydantic
# or with extras
pip install git+https://github.com/pydantic/pydantic@main#egg=pydantic[email]
```

Installation is as simple as:

```bash
pip install pydantic
```

Pydantic has a few dependencies:

* [`pydantic-core`](https://pypi.org/project/pydantic-core/): Core validation logic for _pydantic_ written in rust.
* [`typing-extensions`](https://pypi.org/project/typing-extensions/): Backport of the standard library `typing` module.
* [`annotated-types`](https://pypi.org/project/annotated-types/): Reusable constraint types to use with `typing.Annotated`.

If you've got Python 3.7+ and `pip` installed, you're good to go.

Pydantic is also available on [conda](https://www.anaconda.com) under the [conda-forge](https://conda-forge.org)
channel:

```bash
conda install pydantic -c conda-forge
```

## Optional dependencies

Pydantic has the following optional dependencies:

* If you require email validation, you can add [email-validator](https://github.com/JoshData/python-email-validator).

To install optional dependencies along with Pydantic:

```bash
pip install pydantic[email]
```

Of course, you can also install requirements manually with `pip install email-validator`.

## Install from repository

And if you prefer to install Pydantic directly from the repository:

```bash
pip install git+https://github.com/pydantic/pydantic@main#egg=pydantic
# or with extras
pip install git+https://github.com/pydantic/pydantic@main#egg=pydantic[email]
```
