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

chore: Plugin system documentation #446

Merged
merged 1 commit into from
Oct 10, 2024
Merged

chore: Plugin system documentation #446

merged 1 commit into from
Oct 10, 2024

Conversation

j-lanson
Copy link
Collaborator

Not exactly ready for merge, but ready for the prose to start being looked at.

Lots of documentation on the plugin system for users, how to use the SDK, and a policy expression reference.

Has a lot of @Todos for wiring up hyperlinks. Not sure if our API docs will be available on a website now that we aren't going to publish to crates.io.

Also structure is kind of weird right now because I didn't actually put the "for users" stuff in for-users.md, I just put it right in the index.md. Let me know if you have opinions on what should be split out into separate files.

Resolves #443 . Resolves portions of #396 that I don't want to split out into separate issues.

@j-lanson j-lanson added type: chore Clean up or management task. product: hc Relates to the core "hc" binary product: rust-sdk Relates to the Rust plugin SDK labels Sep 24, 2024
@j-lanson j-lanson self-assigned this Sep 24, 2024
site/content/docs/guide/plugin/policy-expr.md Outdated Show resolved Hide resolved
site/content/docs/guide/plugin/policy-expr.md Outdated Show resolved Hide resolved
site/content/docs/guide/plugin/policy-expr.md Show resolved Hide resolved
@alilleybrinker alilleybrinker marked this pull request as draft October 10, 2024 14:46
@alilleybrinker alilleybrinker changed the title DRAFT: plugin system docs Plugin system documentation Oct 10, 2024
@alilleybrinker alilleybrinker changed the title Plugin system documentation chore: Plugin system documentation Oct 10, 2024
@alilleybrinker alilleybrinker marked this pull request as ready for review October 10, 2024 15:24
@alilleybrinker alilleybrinker dismissed mchernicoff’s stale review October 10, 2024 15:24

All issues resolved.

This commit introduces the initial documentation for the plugin system. There
is still more to do to improve the docs, especially to document the query
API for those who want to write plugins _without_ using an SDK, but this is
at least a good starting point.

Signed-off-by: Andrew Lilley Brinker <[email protected]>
Signed-off-by: Julian Lanson <[email protected]>
@j-lanson j-lanson merged commit 03de2cc into main Oct 10, 2024
7 checks passed
@alilleybrinker alilleybrinker deleted the docs/plugin-system branch November 5, 2024 06:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
product: hc Relates to the core "hc" binary product: rust-sdk Relates to the Rust plugin SDK type: chore Clean up or management task.
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

Document how to use the SDK
3 participants