Skip to content

Conversation

@hds
Copy link
Collaborator

@hds hds commented Oct 22, 2024

The screenshots on the docs.rs page for tokio-console are a bit out of
date. They are from v0.1.8 and still show the Target column instead of
the Kind column.

With the task size instrumentation and new lints which will be released
in the next version of Tokio Console, we need screenshots which match
what the user will see. The same goes for the screenshots in the
repository root README.md, which anyone visiting the repo page on GitHub
will see.

This change adds new screenshots for docs.rs and replaces the README
screenshots. We have to keep the docs.rs images from previous versions
still, since docs.rs pages for previous versions still reference them.

Additionally, a new CI job to build the docs.rs documentation and also
to check that all the images referenced from the tokio-console README
file (which is used on docs.rs) are present in the repository, as we
can't inspect the documentation until the change is merged. This is done
via a new xtask operation.

The screenshots on the docs.rs page for tokio-console are a bit out of
date. They are from v0.1.8 and still show the Target column instead of
the Kind column.

With the task size instrumentation and new lints which will be released
in the next version of Tokio Console, we need screenshots which match
what the user will see. The same goes for the screenshots in the
repository root README.md, which anyone visiting the repo page on GitHub
will see.

This change adds new screenshots for docs.rs and replaces the README
screenshots. We have to keep the docs.rs images from previous versions
still, since docs.rs pages for previous versions still reference them.

Additionally, a new CI job to build the docs.rs documentation and also
to check that all the images referenced from the tokio-console README
file (which is used on docs.rs) are present in the repository, as we
can't inspect the documentation until the change is merged.
@hds hds requested a review from a team as a code owner October 22, 2024 12:42
We're already building the docs on netlify, so no need to do it in
GitHub CI as well. We'll just keep the check for assets.
@hds hds force-pushed the hds/update-screenshots-tokio-console-0-1-13 branch from 0850bf2 to 1563e91 Compare October 23, 2024 14:21
Rather than using a bash script, let's do things properly and validate
the presence of the images in the Tokio Console README.md file with an
xtask operation.

This commit intentially has an error in the regex to check that the CI
step is working.
@hds hds force-pushed the hds/update-screenshots-tokio-console-0-1-13 branch from 1563e91 to 3011906 Compare October 23, 2024 14:22
Now CI should pass..
@hds hds merged commit eff20bd into main Oct 24, 2024
18 checks passed
@hds hds deleted the hds/update-screenshots-tokio-console-0-1-13 branch October 24, 2024 10:01
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.

3 participants