Skip to content

Expand Libs docs with more links and details #392

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

Merged
merged 7 commits into from
Jul 19, 2020

Conversation

KodrAus
Copy link
Contributor

@KodrAus KodrAus commented Jun 30, 2020

Currently includes two new sections:

  • An RFC Merge Procedure that just points to the Lang one, just so it’s easy to discover for anybody who needs to merge Libs RFCs.
  • Some external links in the form of a table in the root Libs page. These are just some GitHub queries that I find regularly useful.

cc @rust-lang/libs what do you think of the idea of using a GitHub topic on repositories in rust-lang to surface repositories we want to keep track of? As a start I’ve just added it to log but thought we could also include:

  • libc
  • futures-rs
  • backtrace-rs
  • api-guidelines
  • packed_simd
  • stdarch
  • regex
  • hashbrown
  • getopts

What do you think?

KodrAus added 4 commits June 30, 2020 22:02
I thought it would be worth adding a section on our RFC merge procedure even though it just points back to the Lang team’s agnostic process so it’s easier for members to find
These are tactical links that are likely to be regularly useful to the Libs team
Co-authored-by: XAMPPRocky <4464295+XAMPPRocky@users.noreply.github.com>
@XAMPPRocky
Copy link
Member

@KodrAus Not on the team, but I would love if there was a list somewhere even if it wasn’t a GitHub Topic that said which of the repositories in rust-lang the libs team takes responsibility for. It would be very helpful when figuring out who needs to be contacted about the crate for whatever reason.

@KodrAus
Copy link
Contributor Author

KodrAus commented Jul 1, 2020

I would love if there was a list somewhere even if it wasn’t a GitHub Topic that said which of the repositories in rust-lang the libs team takes responsibility for

I think this would be great too 👍 I thought a GitHub topic might be a nice way to keep the set relevant so we don’t have to maintain a manual list.

@LukasKalbertodt
Copy link
Member

Thanks for your work! The forge for t-libs could indeed be improved!

cc @rust-lang/libs what do you think of the idea of using a GitHub topic on repositories in rust-lang to surface repositories we want to keep track of?

I don't mind that, but in case you aren't aware, there is also this: https://github.com/orgs/rust-lang/teams/libs/repositories
Not sure how useful that is though. It seems to be all repos that the team has some kind of explicit access to?

And regarding responsibility of repos in rust-lang: it miiight be helpful to assign people from our team to certain repos as "mainly responsible"? To be honest, I unsubscribed from a few repos as all PRs were way over my head and someone else already seems to handle everything. But yeah, maybe it's not a good idea after all, and everyone from t-libs should check every repo once in a while...

@KodrAus
Copy link
Contributor Author

KodrAus commented Jul 12, 2020

I unsubscribed from a few repos as all PRs were way over my head and someone else already seems to handle everything

@LukasKalbertodt That’s not a problem at all! 🙂 There are so many repos that libs works on and the highest traffic of them are very domain-specific so unless you’re immersed in them it’s very hard to keep track of individual issues and commits.

it miiight be helpful to assign people from our team to certain repos as "mainly responsible"?

Having a list of repos along with a libs contact might help to unblock things that come up in those repos, especially for folks outside the team who can’t ping the team have a handle they can ping instead.

@XAMPPRocky
Copy link
Member

XAMPPRocky commented Jul 13, 2020

Having a list of repos along with a libs contact might help to unblock things that come up in those repos, especially for folks outside the team who can’t ping the team have a handle they can ping instead.

I think this would be a great use for project groups. A project group can be scoped to a single crate e.g. a backtrace-rs project group, that would consist of primarily one or two people working on the crate. This would allow the groups to benefit from all the team infrastructure like being on the website and having automatically having a github team like @rust-lang/libs/backtrace-rs. This would be more effort than just a list though.

@KodrAus
Copy link
Contributor Author

KodrAus commented Jul 19, 2020

Another alternative could be to use a GitHub issues like the Lang team does for their project groups: https://github.com/rust-lang/lang-team/labels/project-group

@KodrAus
Copy link
Contributor Author

KodrAus commented Jul 19, 2020

I’ve just removed the link to a list of repos in topics for now so we can still include some useful links in the forge docs and decide how we want to track repos later on.

@KodrAus KodrAus merged commit 04cf389 into rust-lang:master Jul 19, 2020
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.

3 participants