Skip to content

Fix link in documentation of widget::Image#1730

Merged
cmyr merged 3 commits intolinebender:masterfrom
RichardPoole42:image_docfix
Apr 28, 2021
Merged

Fix link in documentation of widget::Image#1730
cmyr merged 3 commits intolinebender:masterfrom
RichardPoole42:image_docfix

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
Member

@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
Member

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.

@josh-audio josh-audio added S-needs-review waits for review S-waiting-on-author waits for changes from the submitter labels Apr 27, 2021
@josh-audio josh-audio removed the S-waiting-on-author waits for changes from the submitter label Apr 27, 2021
@josh-audio josh-audio 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