Skip to content

Conversation

@jsha
Copy link
Contributor

@jsha jsha commented May 24, 2021

Per discussion in #84326. For trait implementations, this was
misleading: the items actually do have documentation (but it comes from
the trait definition).

For both trait implementations and trait implementors, this was
redundant: in both of those cases, the items are default-hidden by
different toggle at the level above.

Update tests: Remove XPath selectors that over-specified on details tag,
in cases that weren't testing toggles. Add an explicit test for toggles
on methods. Rename item-hide-threshold to toggle-item-contents for
consistency.

Demo:
https://hoffman-andrews.com/rust/untoggle-undocumented/std/string/struct.String.html
https://hoffman-andrews.com/rust/untoggle-undocumented/std/io/trait.Read.html

@rust-highfive rust-highfive added the S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. label May 24, 2021
@rust-log-analyzer

This comment has been minimized.

Per discussion in rust-lang#84326. For trait implementations, this was
misleading: the items actually do have documentation (but it comes from
the trait definition).

For both trait implementations and trait implementors, this was
redundant: in both of those cases, the items are default-hidden by
different toggle at the level above.

Update tests: Remove XPath selectors that over-specified on details tag,
in cases that weren't testing toggles. Add an explicit test for toggles
on methods. Rename item-hide-threshold to toggle-item-contents for
consistency.
@jsha jsha force-pushed the untoggle-undocumented branch from e21e330 to 10bafe1 Compare May 31, 2021 04:16
@jsha
Copy link
Contributor Author

jsha commented May 31, 2021

Updated with fixed tests. As noted in the updated PR, I removed some assertions that weren't specifically trying to test toggles, and strengthened the existing tests of toggles.

@GuillaumeGomez
Copy link
Member

Thanks!

@bors: r+ rollup

@bors
Copy link
Collaborator

bors commented Jun 1, 2021

📌 Commit 10bafe1 has been approved by GuillaumeGomez

@bors bors added S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion. and removed S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. labels Jun 1, 2021
bors added a commit to rust-lang-ci/rust that referenced this pull request Jun 1, 2021
…laumeGomez

Rollup of 4 pull requests

Successful merges:

 - rust-lang#85473 (fix split-debuginfo error message)
 - rust-lang#85622 (Remove toggle for "undocumented items.")
 - rust-lang#85826 (Mention "null pointer optimization" in option docs.)
 - rust-lang#85860 (Fix details rustdoc toggle for blanket impl)

Failed merges:

r? `@ghost`
`@rustbot` modify labels: rollup
@bors bors merged commit 085691b into rust-lang:master Jun 1, 2021
@rustbot rustbot added this to the 1.54.0 milestone Jun 1, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants