PMM-12985 Apply v3 API infra modifications and update docs

.github/workflows/doc.yml

@@ -12,7 +12,7 @@ on:
 
 jobs:
   sync:
-    name: Sync
+    name: Sync API Docs
     runs-on: ubuntu-22.04
 
     steps:
@@ -29,11 +29,12 @@ jobs:
           echo "VERSION=$VERSION" >> $GITHUB_ENV
           echo "ID=$ID" >> $GITHUB_ENV
 
-      - name: Provision rdme
-        run: npm install -g rdme
-
       - name: Sync API spec
-        run: rdme openapi ./api/swagger/swagger.json --id=${{ env.ID }} --key=${{ secrets.README_TOKEN }}
+        uses: readmeio/rdme@v8
+        with:
+          rdme: openapi ./api/swagger/swagger.json --version=${{ env.VERSION }} --id=${{ env.ID }} --key=${{ secrets.README_TOKEN }}
 
       - name: Sync Markdown docs
-        run: rdme docs docs/api --version=${{ env.VERSION }} --key=${{ secrets.README_TOKEN }}
+        uses: readmeio/rdme@v8
+        with: 
+          rdme: docs ./docs/api --version=${{ env.VERSION }} --key=${{ secrets.README_TOKEN }}

.github/workflows/main.yml

@@ -96,7 +96,7 @@ jobs:
           fi
 
           # One may need to suppress passing to reviewdog because of https://github.com/reviewdog/reviewdog/issues/1696
-          echo "$out" | bin/reviewdog -f=buf -reporter=github-pr-review -fail-on-error=true
+          echo "$out" | bin/reviewdog -f=buf -reporter=github-pr-review -fail-level=error
 
       - name: Run code linters
         uses: reviewdog/action-golangci-lint@v2
@@ -123,7 +123,7 @@ jobs:
             exit $exit_code
           fi
 
-          echo "$out" | bin/reviewdog -f=go-consistent -reporter=github-pr-review -fail-on-error=true
+          echo "$out" | bin/reviewdog -f=go-consistent -reporter=github-pr-review -fail-level=error
 
       - name: Test common API
         run: make test-common

api/advisors/v1/advisors.proto

@@ -177,7 +177,7 @@ service AdvisorService {
   rpc GetFailedChecks(GetFailedChecksRequest) returns (GetFailedChecksResponse) {
     option (google.api.http) = {get: "/v1/advisors/checks/failed"};
     option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
-      summary: "Get Failed Checks"
+      summary: "Get Failed Advisor Checks"
       description: "Returns the latest check results for a given service."
     };
   }
@@ -196,15 +196,15 @@ service AdvisorService {
   rpc ListAdvisorChecks(ListAdvisorChecksRequest) returns (ListAdvisorChecksResponse) {
     option (google.api.http) = {get: "/v1/advisors/checks"};
     option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
-      summary: "List advisor checks"
+      summary: "List Advisor Checks"
       description: "List advisor checks available to the user."
     };
   }
   // ListAdvisors returns a list of advisors available for the user.
   rpc ListAdvisors(ListAdvisorsRequest) returns (ListAdvisorsResponse) {
     option (google.api.http) = {get: "/v1/advisors"};
     option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
-      summary: "List advisors"
+      summary: "List Advisors"
       description: "List advisors available to the user."
     };
   }

api/advisors/v1/json/v1.json

@@ -21,7 +21,7 @@
         "tags": [
           "AdvisorService"
         ],
-        "summary": "List advisors",
+        "summary": "List Advisors",
         "operationId": "ListAdvisors",
         "responses": {
           "200": {
@@ -160,7 +160,7 @@
         "tags": [
           "AdvisorService"
         ],
-        "summary": "List advisor checks",
+        "summary": "List Advisor Checks",
         "operationId": "ListAdvisorChecks",
         "responses": {
           "200": {
@@ -264,7 +264,7 @@
         "tags": [
           "AdvisorService"
         ],
-        "summary": "Get Failed Checks",
+        "summary": "Get Failed Advisor Checks",
         "operationId": "GetFailedChecks",
         "parameters": [
           {

api/server/v1/json/v1.json

@@ -798,11 +798,11 @@
     },
     "/v1/server/updates/changelogs": {
       "get": {
-        "description": "List all the changes between the installed version and the latest available version",
+        "description": "List all the changes between the installed version and the latest available version.",
         "tags": [
           "ServerService"
         ],
-        "summary": "List all the changes between the installed version and the latest available version",
+        "summary": "Get the changelog",
         "operationId": "ListChangeLogs",
         "responses": {
           "200": {

api/server/v1/server.proto

@@ -250,12 +250,12 @@ service ServerService {
       description: "Checks for available PMM Server updates."
     };
   }
-
+  // ListChangeLogs delivers the changelog.
   rpc ListChangeLogs(ListChangeLogsRequest) returns (ListChangeLogsResponse) {
     option (google.api.http) = {get: "/v1/server/updates/changelogs"};
     option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
-      summary: "List all the changes between the installed version and the latest available version"
-      description: "List all the changes between the installed version and the latest available version"
+      summary: "Get the changelog"
+      description: "List all the changes between the installed version and the latest available version."
     };
   }
   // StartUpdate starts PMM Server update.