Deprecate the old format of trailers in the API, to be replaced with the format of extended_trailers
<!--IssueSummary start-->
<details>
<summary>
Everyone can contribute. [Help move this issue forward](https://handbook.gitlab.com/handbook/marketing/developer-relations/contributor-success/community-contributors-workflows/#contributor-links) while earning points, leveling up and collecting rewards.
</summary>
- [Close this issue](https://contributors.gitlab.com/manage-issue?action=close&projectId=278964&issueIid=435559)
</details>
<!--IssueSummary end-->
## Summary
This issue tracks the deprecation of the old `trailers` field format in the GitLab API, which will be replaced by the `extended_trailers` field format in a future release.
## Background
The `extended_trailers` field has already been implemented and provides enhanced functionality compared to the legacy `trailers` field. To prepare for a future breaking change, we need to mark the old `trailers` field as deprecated while maintaining backward compatibility.
## Tasks
- [ ] Mark the `trailers` field as deprecated in the API code
- [ ] Update API documentation to indicate `trailers` field deprecation
- [ ] Add deprecation notices pointing users to use `extended_trailers` instead
- [ ] Ensure both fields continue to work during the deprecation period
## Related Issues
This is part of the broader effort tracked in https://gitlab.com/groups/gitlab-org/-/epics/12268
Related workstreams:
- https://gitlab.com/gitlab-org/gitlab/-/issues/435557
- https://gitlab.com/gitlab-org/gitlab/-/issues/435558
## Acceptance Criteria
- [ ] The `trailers` field is marked as deprecated in code with appropriate deprecation warnings
- [ ] API documentation clearly indicates the deprecation and migration path to `extended_trailers`
- [ ] Existing functionality remains unchanged during deprecation period
- [ ] Users receive clear guidance on migrating to `extended_trailers`
issue