GitLab REST API "get single repository branch" documentation does not describe return object
<!--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=300946) </details> <!--IssueSummary end--> ### Problem to solve The current version of the [Gitlab REST API documentation (v13.9?)](https://docs.gitlab.com/ee/api/branches.html#get-single-repository-branch) describes how to get information about a given branch. In addition to general branch properties, it returns a `commit` object. What does this particular `commit` object represent? I cannot determine this from the current documentation; branches usually have many commits. ``` { "name": "master", "merged": false, "protected": true, "default": true, "developers_can_push": false, "developers_can_merge": false, "can_push": true, "web_url": "http://gitlab.example.com/my-group/my-project/-/tree/master", "commit": { "author_email": "john@example.com", "author_name": "John Smith", "authored_date": "2012-06-27T05:51:39-07:00", "committed_date": "2012-06-28T03:44:20-07:00", "committer_email": "john@example.com", "committer_name": "John Smith", "id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c", "short_id": "7b5c3cc", "title": "add projects API", "message": "add projects API", "parent_ids": [ "4ad91d3c1144c406e50c7b33bae684bd6837faf8" ] } } ``` ### Proposal The documentation should be clear on what this `commit` object represents. ### Who can address the issue Anyone who knows what the `commit` object means in this context should be able to help here. ### Other links/references https://docs.gitlab.com/ee/api/branches.html#get-single-repository-branch
issue