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

Fix link in documentation of widget::Image #1730

Merged
merged 3 commits into from
Apr 28, 2021

Conversation

RichardPoole42
Copy link
Contributor

struct ImageBuf now lives in piet not in druid-shell

struct ImageBuf now lives in piet not in druid-shell
Copy link
Collaborator

@jneem jneem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch! I think we can do even better, though, now that intra-doc links are stable. This way, the compiler will catch it next time it breaks.

Comment on lines 72 to 74
/// [`ImageBuf`]: ../piet/struct.ImageBuf.html
/// [`FillStrat`]: ../widget/enum.FillStrat.html
/// [`InterpolationMode`]: ../piet/enum.InterpolationMode.html
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// [`ImageBuf`]: ../piet/struct.ImageBuf.html
/// [`FillStrat`]: ../widget/enum.FillStrat.html
/// [`InterpolationMode`]: ../piet/enum.InterpolationMode.html
/// [`ImageBuf`]: piet::ImageBuf
/// [`FillStrat`]: crate::widget::FillStrat
/// [`InterpolationMode`]: piet::InterpolationMode

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we can do even better: if these types are in scope, we don't need to include explicit links to them at all, rustdoc will automatically resolve links with the format [`Type`] if Type is in scope.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've updated with those three lines completely removed. All three links do work in the built documentation.

CHANGELOG.md Show resolved Hide resolved
@SecondFlight SecondFlight added S-needs-review waits for review S-waiting-on-author waits for changes from the submitter labels Apr 27, 2021
@SecondFlight SecondFlight removed the S-waiting-on-author waits for changes from the submitter label Apr 27, 2021
@SecondFlight SecondFlight dismissed their stale review April 27, 2021 20:40

Don't know enough about this to approve, but my review comment is resolved

Copy link
Member

@cmyr cmyr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@cmyr cmyr merged commit 10ab921 into linebender:master Apr 28, 2021
@maan2003 maan2003 removed the S-needs-review waits for review label May 3, 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.

5 participants