[Gatsby] Generate pages from inline docstrings

Hi all,

We use Gatsby to build our developer documentation site, developer.box.com. We recently built a library for LangChain called langchain-box. Initially the source code was in the langchain-ai space and their build process generated an API reference based on RST docstrings inline with the Python code.

We are now in a repo that we host, and thus, we need to generate and host the API reference ourselves. I am investigating the best and most efficient way to go from inline docstrings to pages in Gatsby.

In looking through the plugins, I see transformers for markdown and things like documentjs, but I don’t really see anything specific to docstrings or RST.

I could generate an openapi spec and then use the openapi plugin, but in a perfect world, I could just grab that repo and generate the pages directly.

Has anyone solved this problem?

Hi @Scott_Hurrey, I’ve moved this to the open talk category as this isn’t something within the scope of support.

My advice would be to convert to OpenAPI then use the OpenAPI plugin or Swagger UI. It’s a standard that will come in handy in the future… from experience :slight_smile: