diff --git a/src/types/api/repository.ts b/src/types/api/repository.ts
index b57fb63d..34c39ee8 100644
--- a/src/types/api/repository.ts
+++ b/src/types/api/repository.ts
@@ -34,7 +34,9 @@ export interface Repository {
 	types: Record<string, string>;
 
 	/**
-	 * A list of tags for the repository.
+	 * @deprecated Tags are only available in the forms object.
+	 * 
+	 * @see More details in the blog post "A change to how the Prismic API handles tags": {@link https://prismic.io/blog/a-change-to-how-the-prismic-api-handles-tags}
 	 */
 	tags: string[];
 
@@ -50,7 +52,9 @@ export interface Repository {
 	 */
 	oauth_initiate: string;
 
-	// TODO: Describe this field
+	/**
+	 * The token used for the OAuth process for the repository.
+	 */
 	oauth_token: string;
 
 	/**