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