v2: ci

Signed-off-by: nfel <nfilsaraee@gmail.com>

.gitea/workflows/buf-ci.yaml

@@ -1,10 +1,8 @@
----
 name: Buf CI
 on:
   push:
     tags:
       - v*
-
 permissions:
   contents: read
   pull-requests: write
@@ -14,25 +12,26 @@ jobs:
     steps:
       - uses: actions/setup-go@v5
         with:
-          go-version: '>=1.23.0'
+          go-version: ">=1.23.0"
       - uses: bufbuild/buf-setup-action@v1.47.2
-      - run: go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
-      - run: go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
-      - run: npm init -y && npm install --save @bufbuild/protobuf @bufbuild/protoc-gen-es @bufbuild/buf
-      - run: buf --version
       - uses: actions/checkout@v4
         with:
           token: ${{ gitea.token }}
           path: ./
-      - run: ls -aRl ./
-      - run: buf generate 
+      - run: go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
+      - run: go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
+      - run: go install github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc@latest
+      - run: npm install --save @bufbuild/protobuf @bufbuild/protoc-gen-es @bufbuild/buf
+      - run: buf --version
+      - run: "export PATH=$PATH:./node_modules/.bin\nbuf generate \n"
       - run: |
           if [ -n ${{ gitea.ref_name }} ]; then
             mkdir .res
-            for out in go ts docs; do
-              tar czf .res/${out}.tar.gz ./stub/${out}/ .
-              curl --user gitea:${{ gitea.token }} \
+            for out in go ts doc; do
+              echo releasing ${out} ...
+              tar czf .res/${out}.tar.gz ./stub/${out}/
+              curl -Ss --user nfel:${{ secrets.PROD_REG_TOKEN }}\
                 --upload-file .res/${out}.tar.gz \
-              ${{ gitea.api_url }}/packages/kahroba/generic/proto/${{ gitea.ref_name }}/${out}.tar.gz
+                ${{ gitea.server_url }}/api/packages/Kahroba/generic/proto/${{ gitea.ref_name }}/${out}.tar.gz
             done
           fi

buf.gen.yaml

@@ -20,9 +20,12 @@ plugins:
   # - remote: buf.build/protocolbuffers/go:v1.30.0
     out: stub/go
   # NOTE: doc
-  # - local: protoc-gen-doc
-  #   opt: html,index.html,source_relative
-  #   out: stub/doc
+  - local: protoc-gen-doc
+    opt: html,index.html,source_relative
+    out: stub/doc/html
+  - local: protoc-gen-doc
+    opt: markdown,index.md,source_relative
+    out: stub/doc/md
   # # NOTE: Gateway
   # # - remote: buf.build/grpc-ecosystem/gateway:v2.16.2
   # - local: protoc-gen-grpc-gateway