rust-lang / rust-lang/libs-team

Platform Support: Libs teams relationship with target maintainers

Open
#39 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

meta Non-API
Dominant language
Rust
Stars
178
Forks
28
Avg merge
15m
Merged PRs (30d)
1

Description

Building upon the Target tier policy the libs team would like to more clearly define our relationship with target maintainers and ensure that we are providing support as necessary to them and the work they do within the rust project to maintain support for rust on their respective platforms.

This was brought up in the context of this PR modifying system library linkage on netbsd. In the process of reviewing that PR I realized that we don't have a designated maintainer for netbsd or for many other platforms which got grandfathered in to the new system.

After a discussion with the rest of the libs team we've resolved to work to improve this situation, and we've agreed on the following steps.

  • Open issues for existing platforms that do not have designated maintainers to identify and document existing maintainers, recruit new maintainers, or, if all of that fails, mark the platforms as as unmaintained
  • Create associated ping groups for "target experts" to notify platform maintainers and contributors of changes to their platform so they can participate in those discussions and provide reviews

This came up again in another issue where a new feature was introduced but existing maintainers were not notified of it or given a chance to implement it prior to stabilization. We will be discussing this issue further in the next libs team meeting but I will be recommending that we additionally institute the following changes to our process:

  • Setup general ping groups for each target tier
  • Add "Ping tier2 and tier3 maintainers" as a required step to new tracking issues and again during stabilization for issues introducing features that require platform specific implementations

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 reading the Target tier policy and the linked PR about NetBSD system library linkage, then review the related discussion in issue #74479. Identify platforms without designated maintainers and define the required maintainer and ping-group process. Done means the listed platform and tier support steps are completed and documented.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.