-
-
Notifications
You must be signed in to change notification settings - Fork 159
console api docs #197
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
console api docs #197
Conversation
58fb4bf
to
3a9ec48
Compare
…obuf definition).
3a9ec48
to
a74c2ce
Compare
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.
overall, this looks good to me --- i commented on a couple of minor non-blocking nits.
MetaId metadata_id = 8; | ||
} | ||
|
||
// Represents a period of time in which a program was executing in a particular context. | ||
// | ||
// Corresponds to `Span` in the `tracing` crate. |
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.
it would be really nice if these were links to tracing
's docs, but IDK how prost
's codegen handles markup in doc comments...so not a big deal if we can't easily make this work.
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.
yeah my experience trying to add markup links was very bad. It escaped the [
and ]
characters (or did so nearly always). So lets side-step this for now.
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.
sounds good...it would be nice if there was support for that upstream. that might be worth opening a prost
ticket.
Thanks hawkw! Co-authored-by: Eliza Weisman <[email protected]>
Part of #194: document public API of the console-api crate.