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

console: document views #341

Open
hawkw opened this issue Apr 30, 2022 · 0 comments
Open

console: document views #341

hawkw opened this issue Apr 30, 2022 · 0 comments
Labels
A-docs Area: documentation C-console Crate: console. S-feature Severity: feature. This is adding a new feature.

Comments

@hawkw
Copy link
Member

hawkw commented Apr 30, 2022

What problem are you trying to solve?

Currently, there isn't a lot of documentation that actually explains how to interpret the console's various views. In particular, it would be good to actually discuss what the different columns in the tasks and resources views actually mean. For example, @hdevalence mentioned being confused by the Viz column in the resources view — the meaning of the emojis is not immediately obvious.

How should the problem be solved?

We should add some new documentation to the RustDoc for tokio-console describing what these views mean and how to interpret them. In particular, we should describe the different columns and what they represent.

Any alternatives you've considered?

We may also want to use the help view added by @bIgBV in #243 to display this documentation. It would be nice if the same markdown file could be included in both the help screen at runtime and in the RustDoc, so we don't have to update documentation in two places...

How would users interact with this feature?

No response

Would you like to work on this feature?

maybe

@hawkw hawkw added S-feature Severity: feature. This is adding a new feature. C-console Crate: console. A-docs Area: documentation labels Apr 30, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-docs Area: documentation C-console Crate: console. S-feature Severity: feature. This is adding a new feature.
Projects
None yet
Development

No branches or pull requests

1 participant