upd buf & add doc gen

Author: gertd

.github/workflows/build.yaml

@@ -19,7 +19,7 @@ permissions:
   pull-requests: write
 
 env:
-  BUF_VERSION: "1.61.0"
+  BUF_VERSION: "1.64.0"
 
 jobs:
   build:

README.md

@@ -1,7 +1,23 @@
 # pb-authorizer
 
-Protobuf definitions of Authorizer Service
+Authorizer Service protobuf & gRPC definitions
+
+## API Documentation:
+
+* [Authorizer API](./docs/api.md) 
+
+## Publication:
 
 Buf image is published to [https://buf.build/aserto-dev/authorizer](https://buf.build/aserto-dev/authorizer)
 
-Go generated package [https://github.com/aserto-dev/go-authorizer](https://github.com/aserto-dev/go-authorizer)
+## Implementations:
+
+|Language  | v2 |GitHub Repo|
+|----------|----|-----------|
+|Go        | X  |[https://github.com/aserto-dev/go-authorizer](https://github.com/aserto-dev/go-authorizer)|
+|Java      | X  |[https://github.com/aserto-dev/java-authorizer](https://github.com/aserto-dev/java-authorizer)|
+|Python    | X  |[https://github.com/aserto-dev/python-authorizer](https://github.com/aserto-dev/python-authorizer)|
+|DotNet    | X  |[https://github.com/aserto-dev/dotnet-authorizer](https://github.com/aserto-dev/dotnet-authorizer)|
+|Ruby      | X  |[https://github.com/aserto-dev/ruby-authorizer](https://github.com/aserto-dev/ruby-authorizer)|
+|NodeJS    | X  |[https://github.com/aserto-dev/node-authorizer](https://github.com/aserto-dev/node-authorizer)|
+|TypeScript| X  |[https://github.com/aserto-dev/ts-authorizer](https://github.com/aserto-dev/ts-authorizer)|

buf.gen.yaml

@@ -0,0 +1,15 @@
+---
+version: v2
+
+clean: false
+
+plugins:
+  - remote: buf.build/community/pseudomuto-doc:v1.5.1
+    out: ./docs
+    opt: 
+      - markdown,api.md
+
+  - remote: buf.build/community/pseudomuto-doc:v1.5.1
+    out: ./html
+    opt:
+      - html,index.html

buf.lock

@@ -2,8 +2,8 @@
 version: v2
 deps:
   - name: buf.build/googleapis/googleapis
-    commit: 61b203b9a9164be9a834f58c37be6f62
-    digest: b5:7811a98b35bd2e4ae5c3ac73c8b3d9ae429f3a790da15de188dc98fc2b77d6bb10e45711f14903af9553fa9821dff256054f2e4b7795789265bc476bec2f088c
+    commit: 004180b77378443887d3b55cabc00384
+    digest: b5:e8f475fe3330f31f5fd86ac689093bcd274e19611a09db91f41d637cb9197881ce89882b94d13a58738e53c91c6e4bae7dc1feba85f590164c975a89e25115dc
   - name: buf.build/grpc-ecosystem/grpc-gateway
-    commit: 4c5ba75caaf84e928b7137ae5c18c26a
-    digest: b5:c113e62fb3b29289af785866cae062b55ec8ae19ab3f08f3004098928fbca657730a06810b2012951294326b95669547194fa84476b9e9b688d4f8bf77a0691d
+    commit: 6467306b4f624747aaf6266762ee7a1c
+    digest: b5:c2caa61467d992749812c909f93c07e9a667da33c758a7c1973d63136c23b3cafcc079985b12cdf54a10049ed3297418f1eda42cdffdcf34113792dcc3a990af

buf.yaml

@@ -2,9 +2,11 @@ version: v2
 modules:
   - path: proto
     name: buf.build/aserto-dev/authorizer
+
 deps:
   - buf.build/googleapis/googleapis
   - buf.build/grpc-ecosystem/grpc-gateway
+
 lint:
   use:
     - STANDARD
@@ -16,6 +18,7 @@ lint:
     - SERVICE_SUFFIX
   enum_zero_value_suffix: _UNKNOWN
   disallow_comment_ignores: true
+
 breaking:
   use:
     - FILE