Merge branch 'main' into graphql-schema-update

Author: docubot

content/rest/git/blobs.md

@@ -1,6 +1,8 @@
 ---
-title: Blobs
-intro: 'A Git blob (binary large object) is the object type used to store the contents of each file in a repository.'
+title: Git blobs
+shortTitle: Blobs
+allowTitleToDifferFromFilename: true
+intro: 'The Git blob API lets you create and get a Git blob (binary large object), the object type used to store the contents of each file in a repository.'
 versions:
   fpt: '*'
   ghes: '*'
@@ -11,7 +13,9 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
-The file's SHA-1 hash is computed and stored in the blob object. These endpoints allow you to read and write [blob objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects)
+## About the Git blob API
+
+A Git blob (binary large object) is the object type used to store the contents of each file in a repository. The file's SHA-1 hash is computed and stored in the blob object. These endpoints allow you to read and write [blob objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects)
 to your Git database on {% data variables.product.product_name %}. Blobs leverage [these custom media types](#custom-media-types-for-blobs). You can read more about the use of media types in the API [here](/rest/overview/media-types).
 
 ### Custom media types for blobs

content/rest/git/commits.md

@@ -1,6 +1,8 @@
 ---
-title: Commits
-intro: 'A Git commit is a snapshot of the hierarchy ([Git tree](/rest/reference/git#trees)) and the contents of the files ([Git blob](/rest/reference/git#blobs)) in a Git repository.'
+title: Git commits
+shortTitle: Commits
+allowTitleToDifferFromFilename: true
+intro: 'The Git commits API lets you read and write commit objects to your Git database on {% data variables.product.product_name %}.'
 versions:
   fpt: '*'
   ghes: '*'
@@ -11,4 +13,6 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
-These endpoints allow you to read and write [commit objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) to your Git database on {% data variables.product.product_name %}.
+## About the Git commits API
+
+A Git commit is a snapshot of the hierarchy ([Git tree](/rest/reference/git#trees)) and the contents of the files ([Git blob](/rest/reference/git#blobs)) in a Git repository. These endpoints allow you to read and write [commit objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) to your Git database on {% data variables.product.product_name %}.

content/rest/git/refs.md

@@ -1,6 +1,7 @@
 ---
-title: References
-intro: 'A Git reference (`git ref`) is just a file that contains a Git commit SHA-1 hash.'
+title: Git references
+shortTitle: References
+intro: 'The Git references API lets you read and write references to your Git database on {% data variables.product.product_name %}'
 versions:
   fpt: '*'
   ghes: '*'
@@ -12,4 +13,6 @@ miniTocMaxHeadingLevel: 3
 allowTitleToDifferFromFilename: true
 ---
 
-When referring to a Git commit, you can use the Git reference, which is an easy-to-remember name, rather than the hash. The Git reference can be rewritten to point to a new commit. A branch is just a Git reference that stores the new Git commit hash. These endpoints allow you to read and write [references](https://git-scm.com/book/en/v1/Git-Internals-Git-References) to your Git database on {% data variables.product.product_name %}.
+## About the Git references API
+
+A Git reference (`git ref`) is a file that contains a Git commit SHA-1 hash. When referring to a Git commit, you can use the Git reference, which is an easy-to-remember name, rather than the hash. The Git reference can be rewritten to point to a new commit. A branch is a Git reference that stores the new Git commit hash. These endpoints allow you to read and write [references](https://git-scm.com/book/en/v1/Git-Internals-Git-References) to your Git database on {% data variables.product.product_name %}.

content/rest/git/tags.md

@@ -1,6 +1,8 @@
 ---
-title: Tags
-intro: 'A Git tag is similar to a [Git reference](/rest/reference/git#refs), but the Git commit that it points to never changes.'
+title: Git tags
+shortTitle: Tags
+allowTitleToDifferFromFilename: true
+intro: 'The Git tags API lets you read and write tag objects to your Git database on {% data variables.product.product_name %}.'
 versions:
   fpt: '*'
   ghes: '*'
@@ -11,4 +13,6 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
-Git tags are helpful when you want to point to specific releases. These endpoints allow you to read and write [tag objects](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags) to your Git database on {% data variables.product.product_name %}. The Git tags API only supports [annotated tag objects](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags), not lightweight tags.
+## About the Git tags API
+
+A Git tag is similar to a [Git reference](/rest/reference/git#refs), but the Git commit that it points to never changes. Git tags are helpful when you want to point to specific releases. These endpoints allow you to read and write [tag objects](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags) to your Git database on {% data variables.product.product_name %}. The Git tags API only supports [annotated tag objects](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags), not lightweight tags.

content/rest/git/trees.md

@@ -1,6 +1,8 @@
 ---
-title: Trees
-intro: 'A Git tree object creates the hierarchy between files in a Git repository. '
+title: Git trees
+shortTitle: Trees
+allowTitleToDifferFromFilename: true
+intro: 'The Git trees API lets you read and write tree objects to your Git database on {% data variables.product.product_name %}.'
 versions:
   fpt: '*'
   ghes: '*'
@@ -11,4 +13,6 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
-You can use the Git tree object to create the relationship between directories and the files they contain. These endpoints allow you to read and write [tree objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects) to your Git database on {% data variables.product.product_name %}.
+## About the Git trees API
+
+A Git tree object creates the hierarchy between files in a Git repository. You can use the Git tree object to create the relationship between directories and the files they contain. These endpoints allow you to read and write [tree objects](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects) to your Git database on {% data variables.product.product_name %}.