Uh oh!
There was an error while loading. Please reload this page.
[rustdoc] Page hash handling - #70563
Merged
Merged
Conversation
kinnison
reviewed
Apr 4, 2020
Contributor
There was a problem hiding this comment.
Would it not be better to add a class or somesuch in the generated code so that we're not relying so hard on the exact element structure for this?
MemberAuthor
There was a problem hiding this comment.
The problem is that it would require a way bigger change to simplify the DOM in order to do so. At first I thought about adding an id to the collapse button but in this case, we have both the <code> and the <h2> with ids, making it impossible. This is why I change the page's hash when it's the <code>.
Contributor
There was a problem hiding this comment.
How does the id get into the code/h2 ? if it's purely via the markdown parser then I suppose I can understand the difficulty. If it's in rustdoc though then we ought to be able to do something. Failing that, the rest looks okay and if you're sure it's reliable then you can r=me.
MemberAuthor
There was a problem hiding this comment.
It's worth checking. I'll take another look around to be sure about it.
GuillaumeGomezforce-pushed
the
page-hash-handling
branch
2 times, most recently
from
June 27, 2020 16:10
833ffa4 to
aa5c954CompareGuillaumeGomez
commented
Jun 27, 2020
MemberAuthor
So in the end, I simply removed all the IDs inside the |
rust-highfive
commented
Jun 27, 2020
Contributor
The job Click to expand the log.I'm a bot! I can only do what humans tell me to, so if this was not helpful or you have suggestions for improvements, please ping or otherwise contact |
GuillaumeGomez
commented
Jun 27, 2020
MemberAuthor
cc @jyn514 |
rust-highfive
commented
Jun 27, 2020
Contributor
The job Click to expand the log.I'm a bot! I can only do what humans tell me to, so if this was not helpful or you have suggestions for improvements, please ping or otherwise contact |
GuillaumeGomezforce-pushed
the
page-hash-handling
branch
from
June 28, 2020 13:19
3a30bbc to
7ea2bcfCompareGuillaumeGomez
commented
Jun 29, 2020
MemberAuthor
@kinnison I remove the ids from |
kinnison
commented
Jun 29, 2020
Contributor
The IDs do look nicer in use. And you're sure nothing was relying on the dodgy IDs? |
jyn514
commented
Jun 29, 2020
Member
Well, end-users could be relying on them. Until we stabilize intra-doc links, users have to link using the same format rustdoc generates, so changing the format will break links. Fortunately these were only hashes so the links will only go to the top of the page instead of giving a 404. |
ollie27
commented
Jun 29, 2020
Contributor
The extra IDs are part of #35236. To remove them we have to be sure that nothing is still using them. For example it looks like RLS is: https://github.com/rust-lang/rls/blob/fb46b914c11b06828680cb526e2abe9e1d69b868/rls-analysis/src/lib.rs#L500 |
jyn514
commented
Jun 30, 2020
Member
🤷 |
ollie27
commented
Jul 1, 2020
Contributor
We have git blame... As I said, the IDs were added to FWIW I agree with removing these, but if we're going to remove features we should make some effort to help migrate existing users like RLS. We should also fully revert #35236 not just part of it. |
GuillaumeGomezforce-pushed
the
page-hash-handling
branch
from
July 2, 2020 12:15
7ea2bcf to
e955bebCompareGuillaumeGomez
commented
Jul 2, 2020
MemberAuthor
I completely removed the option everywhere I could find it. Now I wonder: how do we handle this with RLS? ping @nrc |
kinnison
commented
Jul 2, 2020
Contributor
@GuillaumeGomez It may also be worth pinging @Xanewok for rls stuff. |
GuillaumeGomez
commented
Jul 2, 2020
MemberAuthor
Well, you did it. @ollie27: Should we wait for RLS or should we merge? I don't really know how things are supposed to be handled in such a case... Supporting RLS through HTML ids was not a great idea. :-/ |
Xanewok
commented
Jul 6, 2020
Contributor
RLS is currently broken and so I don't think we should block on RLS in this regard. I assume this modifies the behaviour that this snippet relies on: If so, could you help me adapt it to make it work as expected by new behaviour? |
MemberAuthor
The big difference will be that RLS will have to rely on "full" path instead of the weird abbreviated ones it used until now. So for example, a variant is "#variant.name". If you need a direct translation for each item, we can talk about it privately so I can help you more quickly. So if RLS isn't a blocker anymore, let's merge it. @bors r=ollie27,kinnison |
bors
commented
Jul 6, 2020
Collaborator
📌 Commit e955beb has been approved by |
Dylan-DPC-zz pushed a commit
to Dylan-DPC-zz/rust
that referenced
this pull request
Jul 6, 2020
…r=ollie27,kinnison [rustdoc] Page hash handling Fixesrust-lang#70476 A good example to see the change is to use this URL: https://doc.rust-lang.org/nightly/std/string/struct.String.html#from_iter.v-3 After the change, it actually goes to the target element (and change the page hash to something more clear for the users). r? @kinnison cc @ollie27
bors added a commit
to rust-lang-ci/rust
that referenced
this pull request
Jul 7, 2020
…arth Rollup of 14 pull requests Successful merges: - rust-lang#70563 ([rustdoc] Page hash handling) - rust-lang#73856 (Edit librustc_lexer top-level docs) - rust-lang#73870 (typeck: adding type information to projection) - rust-lang#73953 (Audit hidden/short code suggestions) - rust-lang#73962 (libstd/net/tcp.rs: #![deny(unsafe_op_in_unsafe_fn)]) - rust-lang#73969 (mir: mark mir construction temporaries as internal) - rust-lang#73974 (Move A|Rc::as_ptr from feature(weak_into_raw) to feature(rc_as_ptr)) - rust-lang#74067 (rustdoc: Restore underline text decoration on hover for FQN in header) - rust-lang#74074 (Fix the return type of Windows' `OpenOptionsExt::security_qos_flags`.) - rust-lang#74078 (Always resolve type@primitive as a primitive, not a module) - rust-lang#74089 (Add rust-analyzer to the build manifest) - rust-lang#74090 (Remove unused RUSTC_DEBUG_ASSERTIONS) - rust-lang#74102 (Fix const prop ICE) - rust-lang#74112 (Expand abbreviation in core::ffi description) Failed merges: r? @ghost
bors
commented
Jul 7, 2020
Collaborator
bors
commented
Jul 7, 2020
Collaborator
☔ The latest upstream changes (presumably #74117) made this pull request unmergeable. Please resolve the merge conflicts. |
flip1995 pushed a commit
to flip1995/rust
that referenced
this pull request
Jul 14, 2020
…arth Rollup of 14 pull requests Successful merges: - rust-lang#70563 ([rustdoc] Page hash handling) - rust-lang#73856 (Edit librustc_lexer top-level docs) - rust-lang#73870 (typeck: adding type information to projection) - rust-lang#73953 (Audit hidden/short code suggestions) - rust-lang#73962 (libstd/net/tcp.rs: #![deny(unsafe_op_in_unsafe_fn)]) - rust-lang#73969 (mir: mark mir construction temporaries as internal) - rust-lang#73974 (Move A|Rc::as_ptr from feature(weak_into_raw) to feature(rc_as_ptr)) - rust-lang#74067 (rustdoc: Restore underline text decoration on hover for FQN in header) - rust-lang#74074 (Fix the return type of Windows' `OpenOptionsExt::security_qos_flags`.) - rust-lang#74078 (Always resolve type@primitive as a primitive, not a module) - rust-lang#74089 (Add rust-analyzer to the build manifest) - rust-lang#74090 (Remove unused RUSTC_DEBUG_ASSERTIONS) - rust-lang#74102 (Fix const prop ICE) - rust-lang#74112 (Expand abbreviation in core::ffi description) Failed merges: r? @ghost
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
9 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes#70476
A good example to see the change is to use this URL: https://doc.rust-lang.org/nightly/std/string/struct.String.html#from_iter.v-3
After the change, it actually goes to the target element (and change the page hash to something more clear for the users).
r? @kinnison
cc @ollie27