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

[launching-pad] Find a home for the Book Team #123

Open
jamesmunns opened this issue Dec 2, 2024 · 8 comments
Open

[launching-pad] Find a home for the Book Team #123

jamesmunns opened this issue Dec 2, 2024 · 8 comments
Assignees
Labels
A-teams Area: Issues related to teams, such as forming new teams, team structure, etc.

Comments

@jamesmunns
Copy link
Member

jamesmunns commented Dec 2, 2024

This is a tracking issue for finding a long-term home for the Book team.

Leads:

This issue is a sub-issue of #118

@jamesmunns jamesmunns added the A-teams Area: Issues related to teams, such as forming new teams, team structure, etc. label Dec 2, 2024
@jamesmunns jamesmunns self-assigned this Dec 2, 2024
@jamesmunns
Copy link
Member Author

Hey there @carols10cents and @chriskrycho - as part of #118, I'm starting the triage process of trying to find permanent homes for teams under the launching pad.

In this first pass, I'm making tracking issues for each of the teams, starting the discussion on whether y'all think there is a reasonable team you think would make sense to move under, and in general checking whether the members of these teams are still actively working on things (I believe you two are, so probably ✅ on that!).

If you don't have any strong opinions (today) - no worries! I'll likely check back in after the first pass looking for "clearly inactive" groups. But I'm open to capture any thoughts here if you have them already!

@jamesmunns jamesmunns changed the title [launching-pad] Book Team [launching-pad] Find a home for the Book Team Dec 2, 2024
@traviscross
Copy link
Contributor

traviscross commented Dec 16, 2024

This would make sense to be adopted by lang-docs. On lang-docs we already maintain a number of different books.

@jamesmunns
Copy link
Member Author

Hi @carols10cents and @chriskrycho, does the proposal to move the book team under the lang-docs team seem generally agreeable to you?

I've started the discussion in #139 to also move "Rust By Example" under this team, but wanted to get feedback from you before proposing this to the lang-docs team.

@chriskrycho
Copy link

At first blush, that seems reasonable enough as a proposal. That said, I think we should probably make sure we’re all on the same page about what that ends up meaning in practice, as The Book has a fair number of contraints on it because of its relationship to the print version that simply do not apply to other Rust documentation materials, and accordingly also has a more structured notion of “authorship” and is a bit more restrictive in what we do and do not merge.

[N.b. I will be away and not working on this project until Jan. 6, but wanted to reply so you knew I had seen it!]

@chriskrycho
Copy link

chriskrycho commented Jan 6, 2025

Now that we’re back from our holidays, @carols10cents and I chatted about this today and wanted to follow up on the above.

We’re totally fine with the book becoming part of lang-docs in principle, with the following caveats, all of which come down to the aforementioned differences between The Rust Programming Language book and other docs materials (like Rust by Example) for the project (this is a book which goes to print and has discrete/named authors and a specific voice, to name the most salient ones):

  1. Other folks on the team should not be making changes to the infra or the content without getting reviews from us.

    The exception: if rust-lang/book is breaking rust-lang/rust, people should feel entirely empowered to do whatever is necessary to unbreak rust-lang/rust, regardless of whether we’re around.

  2. We do not need to get approvals from other folks on the team to ship our own work on it. (Neither of us gates on each other, either, to be clear!)

  3. Neither of us needs to add a new meeting to our calendar. 😅

To be extra clear, we don’t expect any of that to be an issue or anything, just want to be clear so we are all on the same page about whether moving it into lang-docs is the right move or whether we should come up with something else. If it still makes sense to all of you given those caveats and contraints, then let’s do it!

@traviscross
Copy link
Contributor

Thanks for following up. Yes, that'll all be OK. In fact, the precise idea here is to adopt the book team as a subteam of lang-docs, not to absorb it. I'd still expect it'll operate as it has been.

The PR is up:

@chriskrycho
Copy link

Ah, that seems perfect, then! 👍🏼

@traviscross
Copy link
Contributor

For anyone seeking further context on the PR, please see rust-lang/team#1636 (comment).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-teams Area: Issues related to teams, such as forming new teams, team structure, etc.
Projects
None yet
Development

No branches or pull requests

3 participants