Skip to content

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

Merged
merged 4 commits into from
Dec 15, 2021
Merged

console api docs #197

merged 4 commits into from
Dec 15, 2021

Conversation

pnkfelix
Copy link
Contributor

@pnkfelix pnkfelix commented Dec 15, 2021

Part of #194: document public API of the console-api crate.

@pnkfelix pnkfelix force-pushed the pnk/console-api-docs branch from 58fb4bf to 3a9ec48 Compare December 15, 2021 01:43
@pnkfelix pnkfelix mentioned this pull request Dec 15, 2021
2 tasks
@pnkfelix pnkfelix force-pushed the pnk/console-api-docs branch from 3a9ec48 to a74c2ce Compare December 15, 2021 01:46
Copy link
Member

@hawkw hawkw left a 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.
Copy link
Member

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.

Copy link
Contributor Author

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.

Copy link
Member

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.

@hawkw hawkw merged commit fdf8637 into main Dec 15, 2021
@hawkw hawkw deleted the pnk/console-api-docs branch December 15, 2021 17:58
@hawkw hawkw added this to the 0.1 milestone Dec 15, 2021
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.

2 participants