review

Author: andreaTP

_posts/2025-09-05-grpc-zero.adoc

@@ -14,19 +14,22 @@ author: andreatp
 == TL;DR
 
 Quarkus gRPC Zero brings gRPC code generation into the JVM so you no longer need native 'protoc' binaries. Add the extension, build your project, and the generated stubs appear just like before.
+
 The important outcome is consistent, portable builds across developer machines, CI, containers, and even unusual architectures.
 
 == Why this matters
 
-If you have spent time wrestling with platform-specific 'protoc' binaries, cross-compiled plugins, or flaky CI images, you know the cost: slow onboarding, fragile builds, extra Docker layers, and ongoing maintenance. Quarkus gRPC Zero removes that operational burden so teams can focus on APIs and features instead of shipping native binaries for every target OS and architecture.
+If you have spent time wrestling with platform-specific `protoc` binaries, cross-compiled plugins, or flaky CI images, you know the cost: slow onboarding, fragile builds, extra Docker layers, and ongoing maintenance. Quarkus gRPC Zero removes that operational burden so teams can focus on APIs and features instead of shipping native binaries for every target OS and architecture.
 
 == What Quarkus gRPC Zero does
 
 Quarkus gRPC Zero runs the `protoc` compilation inside the JVM as a pure Java codegen step.
-From a developer point of view nothing changes: you keep writing '.proto' files, run your Quarkus build, and use the generated sources.
+
+From a developer point of view nothing changes: you keep writing `.proto` files, run your Quarkus build, and use the generated sources.
+
 The difference is that builds are portable and predictable on any JVM host.
 
-== Benefits you will see
+== Benefits
 
 * Portable builds that behave the same on laptops, CI, containers, and edge devices.
 * Simpler CI and smaller images because you do not need to package native executables.
@@ -65,6 +68,7 @@ Outcome: the developer ergonomics are unchanged, but there are no native tools t
 == Current status and roadmap
 
 Quarkus gRPC Zero is ready for early adopters.
+
 It passes integration tests and works in typical Quarkus builds.
 We are actively improving the project and welcome feedback, real-world testing, and bug reports to guide stabilization and future features.
 
@@ -82,5 +86,5 @@ We are happy to quickly to turn things around to fix outstanding bugs.
 
 == Closing
 
-Quarkus gRPC Zero is about outcomes: consistent builds and no more native 'protoc' maintenance.
+Quarkus gRPC Zero is about outcomes: consistent builds and no more native `protoc` maintenance.
 Try it, use it in your CI, and please report any feedback so we can make it production-ready for every environment.