rust-lang / rust-lang/team

lang-docs team adoptions charter follow-up

Open
#1,650 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
363
Forks
368
Avg merge
1d 54m
Merged PRs (30d)
59

Description

@jackh726 raised a concern that was missed in the lang-docs team adopting rustlings, rust-by-example, and the book team:

So, I think moving these groups under lang-docs is good idea in terms of organization. But, what I personally would really like to see before this happens is some kind of "charter" from lang-docs on what what is expected from subteams in terms of autonomy and such. It may seem "obvious", but especially given @Chris Krycho's comment re. the book team, I think it would be really good to formalize this.

I would like to follow up with this, which would mean:

  • Revising the lang-docs charter, CC @ehuss @JohnTitor as team leads
  • Adding a charter for rustlings, CC @mo8it, @shadows-withal as team leads
  • Adding a charter for rust-by-example, CC @marioidival as team lead
  • Adding a charter for the book, CC @carols10cents, @chriskrycho as team leads

I agree it is good to document:

  • What the sub-teams are expected to do
  • What responsibility is delegated to the sub-teams (particularly the expected level of autonomy).

Niko provided a potentially useful example of a charter from the proposed project-goals team: https://rust-lang.github.io/rust-project-goals/admin/team.html

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing lang-docs charter and Niko's proposed project-goals team charter example. Follow the linked discussion for the unresolved concern about subteam autonomy, then draft or revise charters for lang-docs, rustlings, rust-by-example, and the book. Done means each charter documents responsibilities, delegation, and expected autonomy.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.