Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WIP: snippet generator interface #13

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

WIP: snippet generator interface #13

wants to merge 1 commit into from

Conversation

JordonPhillips
Copy link
Contributor

This adds and makes use of a snippet generator interface that lets other generators provide examples to be included in the docs.

It's unfortunately more ugly than I'd like, notbably with config. Generators will essentially have to run much of their generator to be able to provide an accurate example, so we have to give a fake plugin context that they can use.

The codegen director will need to be updated to make this more workable.

This is just a proof of concept meant to show how it might work from the doc generator side.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

This adds and makes use of a snippet generator interface that lets
other generators provide examples to be included in the docs.

It's unfortunately more ugly than I'd like, notbably with config.
Generators will essentially have to run much of their generator to
be able to provide an accurate example, so we have to give a fake
plugin context that they can use.

The codegen director will need to be updated to make this more
workable.

This is just a proof of concept meant to show how it might work from
the doc generator side.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant