// css

Contents

GenDocu v0.4 | Swagger UI features for gRPC


We are ready to announce GenDocu’s release 0.4-beta. We have introduced a lot of features, including those known for Swagger UI.

You can test all those new features here.

Try it

/release-v0.4/tryit_gendocu.png

Every RPC (like endpoint in Swagger UI) has its own ‘try it’ button. You can use it to play around with the real API. It automatically authenticates the request based on the selected authentication method.

API Authentication

/release-v0.4/api_auth_1.png

We have embedded the authentication module directly into the documentation. You can select one of the interesting methods and then use it with the try-it feature. The code snippets have it included - you can copy-paste the code without any manual actions. The authentication must be defined inside the configuration file - here is an example. In the current stage, we support only call authentication - channel authentication is postponed.

/release-v0.4/api_auth_2.png

Embeddable widget

Now you don’t have to rely on the GenDocu documentation fully - you can export it as a widget directly into your old documentation. Your widget is by default protected via CORS settings - no one other can embed your documentation on their site.

We have prepared the demo video of that feature. For the demo purpose, we embed the widget inside Tyk.io’s Developer Portal.

Last chance to try CI/CD for gRPC

On 1.11.2021, our gRPC CI/CD is starting to be paid service. It is the last chance to try all the features, including SDK generation, RBAC access, code snippets, and more, for free.

Examples

Programmers (and the gRPC consumers!) love examples. You can create your examples directly in the comment section above the message definition in protofile.

/release-v0.4/example_2.png

GenDocu parses and validates each example. Then it generates code snippets with those examples for all supported languages.

/release-v0.4/example_1.png

Write it once, use it anywhere.

Password protected documentation

In some cases, it is much more convenient to protect the documentation with a password. All the private documentations on GenDocu provide the functionality to create and manage the passwords.

/release-v0.4/password2.png

Creating and using a password is free.

/release-v0.4/password.png

Editing the content

We have also introduced the ability to write your introduction in the documentation (in Markdown) and the authentication description.

/release-v0.4/markdown_docs.png

This month, we introduce the paid plans for all the projects - some features would be excluded from a free plan. The schedule is here. The startup plan would be actively developed - we are planning to add more features, like:

  • Java SDK generation
  • C# SDK generation
  • REST gateway support
  • Multibranch builds

And much more!

The future of GenDocu

Are you interested in using GenDocu? Visit GenDocu or schedule a quick call with us - we would like to hear what problems with gRPC do you have and how we can help you.

Do you like this article? Subscribe newsletter to get more.

We use Mailchimp as our marketing platform. By clicking above to subscribe, you acknowledge that your information will be transferred to Mailchimp for processing. You can unsubscribe anytime. Learn more about Mailchimp's privacy practices here.