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

Rust Docs should not include internal crates #23772

Closed
wycats opened this Issue Mar 27, 2015 · 9 comments

Comments

Projects
None yet
8 participants
@wycats
Copy link
Contributor

wycats commented Mar 27, 2015

For example, when I was originally searching for serialize (in the wrong place, I suppose), I got a bunch of internal results. Link to the search.

std_-_rust

@wycats

This comment has been minimized.

Copy link
Contributor Author

wycats commented Mar 27, 2015

I also feel that we should not have duplicate core and std entries.

@aturon

This comment has been minimized.

Copy link
Member

aturon commented Mar 27, 2015

Paring down what shows up in rustdoc is going to be a key step for 1.0 readiness. Nominating P-high, 1.0 polish.

triage: I-nominated ()

@richo

This comment has been minimized.

Copy link
Contributor

richo commented Mar 27, 2015

cc me, ideally there'll be a frob to still specify the old behaviour. rustdoc has been invaluable when I'm spelunking for something.

@aturon

This comment has been minimized.

Copy link
Member

aturon commented Mar 27, 2015

@richo Yes indeed, it's important that this is still available in some form for people who want to hack on Rust itself.

@bombless

This comment has been minimized.

Copy link
Contributor

bombless commented Mar 27, 2015

I also feel that we should not have duplicate core and std entries.

+1

@tomjakubowski

This comment has been minimized.

Copy link
Contributor

tomjakubowski commented Mar 27, 2015

I swear there was a pretty old open issue for this already but I can't find it. Also cc #22083 which is important and related.

@tomjakubowski

This comment has been minimized.

Copy link
Contributor

tomjakubowski commented Mar 27, 2015

I also feel that we should not have duplicate core and std entries.

This would be addressed for the common Rust user by just removing internal crates (including core) from the docs for the release channel. Nightly users, or at least users of core, and people working on the Rust distribution itself are likely going to want to retain item duplication between core and std because it matters to them.

If you initiate your search from std/core then entries in those crates will come first anyway.

@steveklabnik steveklabnik removed the A-docs label Mar 27, 2015

@tomjakubowski

This comment has been minimized.

Copy link
Contributor

tomjakubowski commented Mar 27, 2015

Duplicate of #21297

@cmr

This comment has been minimized.

Copy link
Member

cmr commented Mar 28, 2015

I'll have a PR for this soon (it's testing)

@cmr cmr closed this in e64b677 Mar 30, 2015

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.