Merge pull request #1558 from github/openapi-update-14cb4dfc9718b70174594a215bc8fcd060cc11ceaffe096b3c78966f72ad9367

Update OpenAPI 3.0 Descriptions

Author: bearcherian

descriptions/api.github.com/api.github.com.json

@@ -30673,7 +30673,7 @@
     "/repos/{owner}/{repo}/community/profile": {
       "get": {
         "summary": "Get community profile metrics",
-        "description": "This endpoint will return all community profile metrics, including an\noverall health score, repository description, the presence of documentation, detected\ncode of conduct, detected license, and the presence of ISSUE\\_TEMPLATE, PULL\\_REQUEST\\_TEMPLATE,\nREADME, and CONTRIBUTING files.\n\nThe `health_percentage` score is defined as a percentage of how many of\nthese four documents are present: README, CONTRIBUTING, LICENSE, and\nCODE_OF_CONDUCT. For example, if all four documents are present, then\nthe `health_percentage` is `100`. If only one is present, then the\n`health_percentage` is `25`.\n\n`content_reports_enabled` is only returned for organization-owned repositories.",
+        "description": "Returns all community profile metrics for a repository. The repository must be public, and cannot be a fork.\n\nThe returned metrics include an overall health score, the repository description, the presence of documentation, the\ndetected code of conduct, the detected license, and the presence of ISSUE\\_TEMPLATE, PULL\\_REQUEST\\_TEMPLATE,\nREADME, and CONTRIBUTING files.\n\nThe `health_percentage` score is defined as a percentage of how many of\nthese four documents are present: README, CONTRIBUTING, LICENSE, and\nCODE_OF_CONDUCT. For example, if all four documents are present, then\nthe `health_percentage` is `100`. If only one is present, then the\n`health_percentage` is `25`.\n\n`content_reports_enabled` is only returned for organization-owned repositories.",
         "tags": [
           "repos"
         ],

descriptions/api.github.com/api.github.com.yaml

@@ -22152,9 +22152,10 @@ paths:
     get:
       summary: Get community profile metrics
       description: |-
-        This endpoint will return all community profile metrics, including an
-        overall health score, repository description, the presence of documentation, detected
-        code of conduct, detected license, and the presence of ISSUE\_TEMPLATE, PULL\_REQUEST\_TEMPLATE,
+        Returns all community profile metrics for a repository. The repository must be public, and cannot be a fork.
+
+        The returned metrics include an overall health score, the repository description, the presence of documentation, the
+        detected code of conduct, the detected license, and the presence of ISSUE\_TEMPLATE, PULL\_REQUEST\_TEMPLATE,
         README, and CONTRIBUTING files.
 
         The `health_percentage` score is defined as a percentage of how many of

descriptions/api.github.com/dereferenced/api.github.com.deref.json

@@ -237782,7 +237782,7 @@
     "/repos/{owner}/{repo}/community/profile": {
       "get": {
         "summary": "Get community profile metrics",
-        "description": "This endpoint will return all community profile metrics, including an\noverall health score, repository description, the presence of documentation, detected\ncode of conduct, detected license, and the presence of ISSUE\\_TEMPLATE, PULL\\_REQUEST\\_TEMPLATE,\nREADME, and CONTRIBUTING files.\n\nThe `health_percentage` score is defined as a percentage of how many of\nthese four documents are present: README, CONTRIBUTING, LICENSE, and\nCODE_OF_CONDUCT. For example, if all four documents are present, then\nthe `health_percentage` is `100`. If only one is present, then the\n`health_percentage` is `25`.\n\n`content_reports_enabled` is only returned for organization-owned repositories.",
+        "description": "Returns all community profile metrics for a repository. The repository must be public, and cannot be a fork.\n\nThe returned metrics include an overall health score, the repository description, the presence of documentation, the\ndetected code of conduct, the detected license, and the presence of ISSUE\\_TEMPLATE, PULL\\_REQUEST\\_TEMPLATE,\nREADME, and CONTRIBUTING files.\n\nThe `health_percentage` score is defined as a percentage of how many of\nthese four documents are present: README, CONTRIBUTING, LICENSE, and\nCODE_OF_CONDUCT. For example, if all four documents are present, then\nthe `health_percentage` is `100`. If only one is present, then the\n`health_percentage` is `25`.\n\n`content_reports_enabled` is only returned for organization-owned repositories.",
         "tags": [
           "repos"
         ],

descriptions/api.github.com/dereferenced/api.github.com.deref.yaml

@@ -46631,9 +46631,10 @@ paths:
     get:
       summary: Get community profile metrics
       description: |-
-        This endpoint will return all community profile metrics, including an
-        overall health score, repository description, the presence of documentation, detected
-        code of conduct, detected license, and the presence of ISSUE\_TEMPLATE, PULL\_REQUEST\_TEMPLATE,
+        Returns all community profile metrics for a repository. The repository must be public, and cannot be a fork.
+
+        The returned metrics include an overall health score, the repository description, the presence of documentation, the
+        detected code of conduct, the detected license, and the presence of ISSUE\_TEMPLATE, PULL\_REQUEST\_TEMPLATE,
         README, and CONTRIBUTING files.
 
         The `health_percentage` score is defined as a percentage of how many of