Skip to content

Latest commit

 

History

History
15 lines (11 loc) · 874 Bytes

README.md

File metadata and controls

15 lines (11 loc) · 874 Bytes

Interactive web documentation for Protocol Buffers

Jakub Dobrý, [email protected]


Assignment

The aim of the work is to design and implement a static web presentation generator for gRPC API documentation. The input files are proto files that carry a description of services, calls and types. The output is an HTML page with documentation and the ability to call the API (provided that the API supports gRPC-web).

  1. Research existing solutions for Protocol Buffers and compare features with similar tools for GraphQL or RESTful APIs.
  2. Design and implement a documentation generator with the ability to call an existing gRPC-web API.
  3. Discuss and possibly implement an alternative data source using gRPC reflection.
  4. Test the application with automated tests and perform user testing.