-
Notifications
You must be signed in to change notification settings - Fork 41
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
Add basic check tracing doc #215
Conversation
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
@@ -1,5 +1,5 @@ | |||
import { Callout } from 'nextra/components' | |||
import YouTube from 'react-youtube' | |||
import { Callout } from "nextra/components"; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nit: single quotes for mdx files
|
||
SpiceDB supports tracing of check requests to view the path(s) taken to compute the result, as well as timing information. | ||
|
||
This information is requested via a header (versions older than v1.31.0) or setting `with_tracing: true` (v1.31.0 or later), and |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Might be more clear to separate the info here into separate sections: Versions previous to v1.31.0 and versions v1.31.0 on
Also specify where to set with_tracing eg in the request body.
### Versions older than v1.31.0 | ||
|
||
Request tracing information via a header and the information is found in the response footer as JSON. | ||
|
||
### v1.31.0 or later | ||
|
||
Request tracing information by setting `with_tracing: true` in the request message and the information is found in the response message. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it might be a better structure to the page if this just documents the v1.31 behavior with a warning about using the header for older versions rather than having two additional layers of nesting headings.
**Warning:** | ||
Versions older than v1.31.0 | ||
|
||
Request tracing information via a header and the information will be found in the response footer as JSON. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nitpick: indent this too
No description provided.