Deprecate old gitlab_project mirror fields
This update describes a new way to handle GitLab project mirroring (automatically syncing code from another repository). Previously, mirror settings were configured directly on the main project resource, but now they've been moved to a separate dedicated resource called gitlab_project_pull_mirror.
The changes include:
- Adding migration documentation that shows users how to move from the old approach to the new one
- Marking the old mirror-related settings as deprecated with warnings that they'll be removed in version 19.0
- Updating all examples and documentation to show the new recommended approach
- The migration process temporarily removes the mirror during the update, then recreates it with the new resource