Checkbox to hide unstable things?

[gilescope]

It would be great on the docs if there was a checkbox to hide nightly only methods in the generated documentation.
That gives us less methods to wade through to find the one we're after potentially, and may encourage people to pick stable methods by preference.

Apologies if this is the wrong repo for this request?

[GuillaumeGomez]

I guess this is the good one. So if I follow correctly: you'd like an option somewhere to be able to hide nightly methods right? Which means that we can't generate both versions, that'd double the size. Therefore, we can do it using JS I guess. To be debated to check if we want more JS.

[gilescope]

I think if all the nightly stuff is a certain css class then a checkbox can toggle visibility of that class...

…

On Mon, 13 Jan 2020 at 16:31, Guillaume Gomez ***@***.***> wrote: I guess this is the good one. So if I follow correctly: you'd like an option somewhere to be able to hide nightly methods right? Which means that we can't generate both versions, that'd double the size. Therefore, we can do it using JS I guess. To be debated to check if we want more JS. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <https://github.com/rust-lang/docs.rs/issues/564?email_source=notifications&email_token=AAGEJCEN42LRXSMVT4I4G73Q5SJOLA5CNFSM4KGFBTQKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEIZL7AI#issuecomment-573751169>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAGEJCE3BSVQ6ZZYE3LX3ZDQ5SJOLANCNFSM4KGFBTQA> .

[jyn514]

@GuillaumeGomez can you transfer to rust-lang/rust since this is a feature request for rustdoc?

[pietroalbini]

Transferred.

[GuillaumeGomez]

I can already tell that I'm not in favor to add this feature into rustdoc directly: it adds more front-end code for a small gain.

[joshtriplett]

Not in the generated documentation pages (where it helps to know they exist), but perhaps in the search page. When doing a search, you might turn up many unstable methods, and it's good to know they exist, but then you might want to narrow to a method you can use and check that box. (It should always start out unchecked on each search, and just be something you can check to dynamically hide the unstable methods that the search turns up.)

[SimonSapin]

Rather than a dynamic choice left to users, would it make sense to have a static configuration for https://doc.rust-lang.org/stable/std/ v.s. https://doc.rust-lang.org/nightly/std/ ?

[dcarosone]

I like the idea that it is just a display filter / toggle, along the lines of other sections that can be expanded and collapsed.

The default state of the toggle could be different depending on whether I'm running cargo doc on a nightly or stable toolchain - and for the web cases immediately above.

There are also deprecated things that might be worth filtering similarly, for the "simple" view of "what can I use on stable now?"

[GuillaumeGomez]

@dcarosone This is more or less the case.

@SimonSapin Yes, I agree with you on this one.

[tesuji]

cc #59853

[detly]

I am currently wading through the documentation on Box and almost every method is nightly-experimental. It is extremely hard to simply see the stable part of the API. I would love a way to switch this off and just focus on what I need.

(In other words, a checkbox to hide the blocks of nox would help the docs on Box not flummox.)