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

error: use intra-doc link #2067

Closed
wants to merge 1 commit into from
Closed

Conversation

ben0x539
Copy link
Contributor

Motivation

ErrorLayer's docs link to SpanTrace using a relative (../) path.
This works out wrong for the public re-export of ErrorLayer in the
crate root.

Solution

Change to an intra-doc link which rustdoc knows to resolve whether
rendering the doc comment for the crate root or for the mod actually
defining ErrorLayer.

`ErrorLayer`'s docs linked to `SpanTrace` using a relative (`../`) path.
This works out wrong for the public re-export of `ErrorLayer` in the
crate root.

Change to an intra-doc link which rustdoc knows to resolve whether
rendering the doc comment for the crate root or for the mod actually
defining `ErrorLayer`.
@ben0x539 ben0x539 requested review from yaahc and a team as code owners April 12, 2022 06:03
@ben0x539
Copy link
Contributor Author

I had crate::SpanTrace first, but when I checked the master branch to see if it has the same problem, I saw it uses super::SpanTrace so let's go with that.

@ben0x539
Copy link
Contributor Author

actually this kind of thing happens in a lot of places doesn't it

@ben0x539
Copy link
Contributor Author

let's not, in favor of #2068

@ben0x539 ben0x539 closed this Apr 12, 2022
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.

None yet

1 participant