docusaurus-protobuffet icon indicating copy to clipboard operation
docusaurus-protobuffet copied to clipboard

Docusaurus toolset for Protobuf contract documentation.

Docusaurus Protobuf Project

Visit the landing page for Protobuffet documentation.

Docusaurus toolset for Protobuf contract documentation. Provides a set of components and MDX doc file generators for Docusaurus sites.

This is a Lerna project containing all packages.

Usage

See docusaurus-protobuffet for details on usage.

See docusaurus-protobuffet-init to create a new Docusaurus project with this toolset installed.

Features

Existing

  • React components for documenting Protobuf file descriptors including messages, services, and enums.
  • Markdown doc (mdx) generation for the Docusaurus platform.
  • Docusaurus sidebar object generation for a complete documentation workspace.

Planned

  • Extension support for generated sidebar and mdx files.
  • Service implementation and client documentation.

Demo

Protodocs Overview Service Sample

Visit the documentation site for an interactive demo.

Packages

docusaurus-protobuffet

Docusaurus preset to help mount the plugin and render all generated files.

docusaurus-protobuffet-init

Docusaurus project generator to scaffold a new site with these packages installed in a recommended setup.

docusaurus-protobuffet-plugin

Docusaurus plugin containing the CLI commands, file generators, and components.

Contributing

Contributions, issues and feature requests are always welcome!