Code

Target tier policy#2803

Code

Merged

jyn514 merged 166 commits intorust-lang:masterrust-lang/rfcs:masterfrom joshtriplett:target-tier-policyjoshtriplett/rfcs:target-tier-policyCopy head branch name to clipboardApr 29, 2021

+771

Commits

Commits on Nov 4, 2019

• Target tier policy

  Show description for 14a9c4f
  joshtriplett

  committed
  14a9c4f

  Copy full SHA for 14a9c4f

Commits on Jul 11, 2020

• Document where we should post the official target tier policy

  joshtriplett

  committed
  2eb8f5f

  Copy full SHA for 2eb8f5f

• Expand discussion of how to track and reach target maintainers

  Show description for 58240cf
  joshtriplett

  committed
  58240cf

  Copy full SHA for 58240cf

• s/ports/targets/

  joshtriplett

  committed
  c883f5d

  Copy full SHA for c883f5d

• Clarify "broader ecosystem"

  joshtriplett

  committed
  a4e88d8

  Copy full SHA for a4e88d8

• Cover targets leaving portions of the standard library unimplemented!()

  joshtriplett

  committed
  13da5e1

  Copy full SHA for 13da5e1

• Add a note about the extent of tool support for targets

  joshtriplett

  committed
  b3152e8

  Copy full SHA for b3152e8

• Consistently use "target" rather than "platform"

  joshtriplett

  committed
  178b102

  Copy full SHA for 178b102

• Elaborate on "must not break any existing target"

  Show description for 53628f8
  joshtriplett

  committed
  53628f8

  Copy full SHA for 53628f8

• Formatting improvements

  joshtriplett

  committed
  f88d05a

  Copy full SHA for f88d05a

• Discuss alternative means of handling team consensus

  joshtriplett

  committed
  43b4891

  Copy full SHA for 43b4891

• Explain subjective requirements like "substantial, widespread interest"

  joshtriplett

  committed
  3a3b3f8

  Copy full SHA for 3a3b3f8

• Rephrase link to platform support page, and provide link text

  joshtriplett

  committed
  e52dac1

  Copy full SHA for e52dac1

• Clarify approval of CI-related requirements.

  joshtriplett

  committed
  159dbf1

  Copy full SHA for 159dbf1

• Update link to avoid redirect

  joshtriplett

  committed
  435cc9b

  Copy full SHA for 435cc9b

• Drop unnecessary parentheses

  joshtriplett

  committed
  5a37367

  Copy full SHA for 5a37367

• Move note about posting this policy out of the guide-level explanation

  joshtriplett

  committed
  d33d656

  Copy full SHA for d33d656

• Expand introduction for reference-level explanation

  joshtriplett

  committed
  4a87994

  Copy full SHA for 4a87994

• Consistently use more precise language "may contact" for contacting teams

  joshtriplett

  committed
  22424e4

  Copy full SHA for 22424e4

• Make "at least 2 developers" a hard requirement for tier 2 targets

  joshtriplett

  committed
  522d3a4

  Copy full SHA for 522d3a4

• Clarify that new tier 2 targets must cross-compile

  joshtriplett

  committed
  8b52472

  Copy full SHA for 8b52472

• More precise language: s/shall/must/

  joshtriplett

  committed
  ea1549c

  Copy full SHA for ea1549c

• Explain that targets may be temporarily disabled in nightlies

  joshtriplett

  committed
  b30bb08

  Copy full SHA for b30bb08

Commits on Jul 12, 2020

• Explicitly define terms like "target development team"

  joshtriplett

  committed
  cc7c1a5

  Copy full SHA for cc7c1a5

• Make it a hard requirement to document how to build and run tests

  joshtriplett

  committed
  97620fa

  Copy full SHA for 97620fa

• Define "CI" on first use

  joshtriplett

  committed
  7ec7ff1

  Copy full SHA for 7ec7ff1

• Note up front that the tier requirements are cumulative

  joshtriplett

  committed
  4dcf8d8

  Copy full SHA for 4dcf8d8

• Note up front about approving teams and subjective judgment

  joshtriplett

  committed
  7d41f4e

  Copy full SHA for 7d41f4e

• Discuss baseline expectations for CPU features, OS versions/features, etc

  Show description for 395f5f1
  joshtriplett

  committed
  395f5f1

  Copy full SHA for 395f5f1

• Add a (subjective) requirement to not disable an excessive number of tests

  joshtriplett

  committed
  523c8ea

  Copy full SHA for 523c8ea

• Add a tier 1 requirement discussing implementation of the standard library

  joshtriplett

  committed
  c32f79a

  Copy full SHA for c32f79a

• Hard requirement to discuss changes to shared code with the compiler team

  joshtriplett

  committed
  1b28be0

  Copy full SHA for 1b28be0

• Meet the requirements before proposing the target

  joshtriplett

  committed
  29c6c5e

  Copy full SHA for 29c6c5e

• Clarifications about baseline expectations

  joshtriplett

  committed
  39afc67

  Copy full SHA for 39afc67

• Tier 2 targets may be required to pass basic smoke tests

  joshtriplett

  committed
  5f839e3

  Copy full SHA for 5f839e3

• Move approving teams out of the bullet lists of requirements

  Show description for 2fdcfe1
  joshtriplett

  committed
  2fdcfe1

  Copy full SHA for 2fdcfe1

• Move up the note about human judgment and "spirit of the requirements"

  Show description for 3c0dc66
  joshtriplett

  committed
  3c0dc66

  Copy full SHA for 3c0dc66

• Update summary. Remove "objective". Actually summarize the RFC.

  joshtriplett

  committed
  a067660

  Copy full SHA for a067660

• Add precedents for tiered target support

  joshtriplett

  committed
  e43096a

  Copy full SHA for e43096a

• Elaborate on slow builds

  joshtriplett

  committed
  2ca6bf3

  Copy full SHA for 2ca6bf3

• Simplify explanation of building in CI

  joshtriplett

  committed
  f7f4c9e

  Copy full SHA for f7f4c9e

• Reword and unify notes about where this policy will live

  joshtriplett

  committed
  8884f78

  Copy full SHA for 8884f78

• Expand future possibilities

  joshtriplett

  committed
  bf9aa88

  Copy full SHA for bf9aa88

• Clarify requirements to provide build and test documentation

  Show description for da57e47
  joshtriplett

  committed
  da57e47

  Copy full SHA for da57e47

• Add a missing comma

  joshtriplett

  committed
  1e98267

  Copy full SHA for 1e98267

• Move demotion/removal discussion out of bullet lists

  Show description for 0ccaaff
  joshtriplett

  committed
  0ccaaff

  Copy full SHA for 0ccaaff

• Note that tier 1 direct removal is highly unlikely

  joshtriplett

  committed
  d1f08f9

  Copy full SHA for d1f08f9

• Minor wording clarification about naming consistency

  joshtriplett

  committed
  571ab02

  Copy full SHA for 571ab02

• Change "on call" to "available"

  Show description for 1c4bc2a
  joshtriplett

  committed
  1c4bc2a

  Copy full SHA for 1c4bc2a

• Clean up wording to be less colloquial

  joshtriplett

  committed
  e386c26

  Copy full SHA for e386c26

• Relocate a note about the target development team

  joshtriplett

  committed
  d2e86f5

  Copy full SHA for d2e86f5

• Alternatives: concrete time requirements before introduction/promotion

  joshtriplett

  committed
  c6dcb4e

  Copy full SHA for c6dcb4e

• Unify terminology towards "target maintainers" instead of "target development team"

  joshtriplett

  committed
  ebdc7f0

  Copy full SHA for ebdc7f0

• Clarify "reviewers of pull requests"

  joshtriplett

  committed
  82f711b

  Copy full SHA for 82f711b

• Consistently use "must" for requirements

  joshtriplett

  committed
  2290377

  Copy full SHA for 2290377

• Specify use of must/should/may language

  Show description for 9ef6e86
  joshtriplett

  committed
  9ef6e86

  Copy full SHA for 9ef6e86

• Even a tier 3 target should have target maintainers on record

  Show description for 2889419
  joshtriplett

  committed
  2889419

  Copy full SHA for 2889419

• Require a compiler-team reviewer for tier 3, not just any reviewer

  joshtriplett

  committed
  dcb6344

  Copy full SHA for dcb6344

• Drop mention of appeals

  joshtriplett

  committed
  5fc80f8

  Copy full SHA for 5fc80f8

• Fix expansion of MCP, and reference it in tier 2 as well

  joshtriplett

  committed
  d6458f6

  Copy full SHA for d6458f6

• Suggest a full RFC for tier 1 target proposals

  Show description for 5b4393b
  joshtriplett

  committed
  5b4393b

  Copy full SHA for 5b4393b

• Allow for infra reporting consensus via a team member

  joshtriplett

  committed
  da1d1cf

  Copy full SHA for da1d1cf

Commits on Jul 13, 2020

• Simplify some approval-related language

  joshtriplett

  committed
  3b6015c

  Copy full SHA for 3b6015c

• Clarify what "as much of the standard library as possible" means

  Show description for 5ed4ebc
  joshtriplett

  committed
  5ed4ebc

  Copy full SHA for 5ed4ebc

• C calling convention

  joshtriplett

  committed
  d732684

  Copy full SHA for d732684

• Add legal and licensing requirements

  joshtriplett

  committed
  1ff321e

  Copy full SHA for 1ff321e

• Reword summary of tiers for clarity

  joshtriplett

  committed
  4e5acef

  Copy full SHA for 4e5acef

Commits on Jul 17, 2020

• A target should spend a reasonable amount of time at each tier

  joshtriplett

  committed
  751f396

  Copy full SHA for 751f396

• Rephrase guidance on a reasonable amount of time

  joshtriplett

  committed
  027542f

  Copy full SHA for 027542f

• Clarify tier 2 requirement: niche targets are fine

  joshtriplett

  committed
  21347b0

  Copy full SHA for 21347b0

Commits on Sep 29, 2020

• Document requirements for providing ways to run the target

  joshtriplett

  committed
  07c4f35

  Copy full SHA for 07c4f35

• Document requirement to not have safety-related deficiencies

  Show description for 4572c26
  joshtriplett

  committed
  4572c26

  Copy full SHA for 4572c26

Commits on Dec 14, 2020

• Wording tweak about tier 2 targets passing tests

  joshtriplett

  committed
  8eb74fa

  Copy full SHA for 8eb74fa

• Update requirement about designated developers

  joshtriplett

  committed
  f81e0fb

  Copy full SHA for f81e0fb

• Add RFC PR link

  joshtriplett

  committed
  c9c51f4

  Copy full SHA for c9c51f4

• Add note that targets require ongoing maintenance

  Show description for 444b6d8
  joshtriplett

  committed
  444b6d8

  Copy full SHA for 444b6d8

• Grammatical improvement

  joshtriplett

  committed
  a4aa114

  Copy full SHA for a4aa114

• Encourage use of consistent naming conventions

  Show description for 4c70962
  joshtriplett

  committed
  4c70962

  Copy full SHA for 4c70962

• Allow tier 3 code to omit *or* stub out code, as appropriate

  joshtriplett

  committed
  f9ac528

  Copy full SHA for f9ac528

• Make sure the policy doesn't stifle discussions about tier 3 targets

  Show description for d7a209d
  joshtriplett

  committed
  d7a209d

  Copy full SHA for d7a209d

• Don't specifically refer to unimplemented!()

  joshtriplett

  committed
  76b0684

  Copy full SHA for 76b0684

• Grammatical tweak: remove a "the"

  joshtriplett

  committed
  900a5b2

  Copy full SHA for 900a5b2

• Add some samples of "onerous" license terms

  Show description for 1d967a7
  joshtriplett

  committed
  1d967a7

  Copy full SHA for 1d967a7

• Add note about future legal review processes

  joshtriplett

  committed
  837a787

  Copy full SHA for 837a787

• Update some git branch names

  joshtriplett

  committed
  bb708a0

  Copy full SHA for bb708a0

• Link to Debian archive criteria source

  joshtriplett

  committed
  989776e

  Copy full SHA for 989776e

• Substantial expansion to cover host tools separately

  Show description for e9154cc
  joshtriplett

  committed
  e9154cc

  Copy full SHA for e9154cc

• Separate out host tool transition steps from requirements

  joshtriplett

  committed
  90f1b79

  Copy full SHA for 90f1b79

• Clarify a legal requirement

  joshtriplett

  committed
  df12647

  Copy full SHA for df12647

• Modify requirement for cross-compilation support

  Show description for a0da271
  joshtriplett

  committed
  a0da271

  Copy full SHA for a0da271

• Avoid redundantly restating approving teams within host tools requirements

  joshtriplett

  committed
  c430135

  Copy full SHA for c430135

• Wording tweak for host tools

  joshtriplett

  committed
  aaad0e4

  Copy full SHA for aaad0e4

• Targets and their tiers (including "with host tools") will be listed

  joshtriplett

  committed
  2e97216

  Copy full SHA for 2e97216

• Clarification on target naming and disruption of renaming

  joshtriplett

  committed
  e1be462

  Copy full SHA for e1be462

• Move clarifiation of "onerous"

  joshtriplett

  committed
  ddbda1b

  Copy full SHA for ddbda1b

• Add sample smoke test ./x.py test --no-run

  joshtriplett

  committed
  408614e

  Copy full SHA for 408614e

• Mention target name ambiguity

  joshtriplett

  committed
  5247216

  Copy full SHA for 5247216

• Clarify why naming is important even for a tier 3 target

  joshtriplett

  committed
  d78eb1e

  Copy full SHA for d78eb1e

• Mention the alternative possibility of renumbering tiers

  joshtriplett

  committed
  d2fa76a

  Copy full SHA for d2fa76a

• Simplify summary

  joshtriplett

  committed
  f3ba93b

  Copy full SHA for f3ba93b

• Clarify summary of tier 3 targets

  joshtriplett

  committed
  0a424a6

  Copy full SHA for 0a424a6

• Clarify promotion timing requirements

  joshtriplett

  committed
  897c3e2

  Copy full SHA for 897c3e2

• Timing of changes that might break targets

  joshtriplett

  committed
  3ceaa79

  Copy full SHA for 3ceaa79

• Elaborate a bit on co-evolving targets

  joshtriplett

  committed
  1d5a8fc

  Copy full SHA for 1d5a8fc

• Note that cross-compiling the testsuite is OK

  joshtriplett

  committed
  f505fcd

  Copy full SHA for f505fcd

• Mention "development platform" and "compilation target"

  joshtriplett

  committed
  220ce56

  Copy full SHA for 220ce56

• Clarify that demotion of a tier 1 target requires a full RFC

  joshtriplett

  committed
  dc652a0

  Copy full SHA for dc652a0

• Discussion demotion of tier 1 targets with host tools

  joshtriplett

  committed
  14948a0

  Copy full SHA for 14948a0

• Clarify that, for a demotion, a target must still meet the lower-tier requirements

  joshtriplett

  committed
  b48aa51

  Copy full SHA for b48aa51

• Allow tier 1 targets to raise their baseline without a full RFC

  joshtriplett

  committed
  a5c8469

  Copy full SHA for a5c8469

• Add some notes to help avoid conflicts of interest

  Show description for 2f7df80
  joshtriplett

  committed
  2f7df80

  Copy full SHA for 2f7df80

• Add expectations about emulation accuracy

  joshtriplett

  committed
  bf3ddb6

  Copy full SHA for bf3ddb6

• Add further discussion and requirements regarding performance considerations

  joshtriplett

  committed
  0697637

  Copy full SHA for 0697637

Commits on Mar 8, 2021

• Document prior art for how to track and contact target maintainers

  joshtriplett

  committed
  5558409

  Copy full SHA for 5558409

• Adjust language about alloc to avoid prescriptive policy about allocators

  Show description for c996aea
  joshtriplett

  committed
  c996aea

  Copy full SHA for c996aea

Commits on Mar 15, 2021

• Clarify requirements about signing, and apply it to all tier 1 targets

  Show description for 4509ce9
  joshtriplett

  committed
  4509ce9

  Copy full SHA for 4509ce9

• Minor rewording of references to requirements of other tiers

  Show description for fcb6ce6
  joshtriplett

  committed
  fcb6ce6

  Copy full SHA for fcb6ce6

Commits on Mar 19, 2021

• Improve clarity of tier 2 summary

  joshtriplett

  committed
  7a6261a

  Copy full SHA for 7a6261a

• Provide some information about "host tools" when first mentioned

  joshtriplett

  committed
  d63374a

  Copy full SHA for d63374a

• Sync wording between the start of the guide-level and reference-level sections

  joshtriplett

  committed
  d1d29ec

  Copy full SHA for d1d29ec

Commits on Mar 23, 2021

• Require documentation of limitations to appear in the target tier list

  Show description for 97ce961
  joshtriplett

  committed
  97ce961

  Copy full SHA for 97ce961

• Fix typo ("of providing of")

  joshtriplett

  committed
  2d5a397

  Copy full SHA for 2d5a397

• Slightly soften a "should"

  joshtriplett

  committed
  d3f9f29

  Copy full SHA for d3f9f29

• Document what happens if the compiler's safety properties broaden

  joshtriplett

  committed
  a36998b

  Copy full SHA for a36998b

• Demotion or removal will be communicated to the target maintainers

  Show description for e840d51
  joshtriplett

  committed
  e840d51

  Copy full SHA for e840d51

• Fix duplicated phrase

  joshtriplett

  committed
  55d3c0c

  Copy full SHA for 55d3c0c

• Expand language about safety properties; narrow to soundness issues

  Show description for e60be23
  joshtriplett

  committed
  e60be23

  Copy full SHA for e60be23

• Add requirements to not substantially raise the maintenance burden of CI

  joshtriplett

  committed
  86a25a4

  Copy full SHA for 86a25a4

• Clarification on tier 1 with host tools as evaluated by the release team

  Show description for 5bd47d1
  joshtriplett

  committed
  5bd47d1

  Copy full SHA for 5bd47d1

• Clarification on tier 1 as evaluated by the release team

  Show description for 10f3d18
  joshtriplett

  committed
  10f3d18

  Copy full SHA for 10f3d18

• Update tier 2 requirement about not blocking PRs to match tier 3 language

  joshtriplett

  committed
  7740056

  Copy full SHA for 7740056

• Make requirements about unwanted messages more strict

  Show description for 1df1714
  joshtriplett

  committed
  1df1714

  Copy full SHA for 1df1714

• Add some subjectivity regarding communications of target demotion/removal

  Show description for 0f25999
  joshtriplett

  committed
  0f25999

  Copy full SHA for 0f25999

• Allow for targets implementing std without having a full OS

  Show description for afd1240
  joshtriplett

  committed
  afd1240

  Copy full SHA for afd1240

• Clarify tier 3 requirement about breaking other tier 3 targets

  Show description for f41e114
  joshtriplett

  committed
  f41e114

  Copy full SHA for f41e114

Commits on Mar 24, 2021

• Drop "new" as a qualifier for rules intended to apply to existing targets

  Show description for 39c73e8
  joshtriplett

  committed
  39c73e8

  Copy full SHA for 39c73e8

• Clarify recusal

  joshtriplett

  committed
  ba9d93e

  Copy full SHA for ba9d93e

• Minor wording tweaks in future possibilities

  joshtriplett

  committed
  d23c1ae

  Copy full SHA for d23c1ae

• Future possibilities: Document scope and potential communication improvements

  joshtriplett

  committed
  db9e8e6

  Copy full SHA for db9e8e6

• Fix spacing

  joshtriplett

  committed
  be98dd6

  Copy full SHA for be98dd6

• Allow for revocable agreements for signing keys

  joshtriplett

  committed
  3350356

  Copy full SHA for 3350356

• Require that signing processes be available to others as well

  joshtriplett

  committed
  c174268

  Copy full SHA for c174268

• Allow signing-related agreements to involve a nominal fee

  Show description for a870b01
  joshtriplett

  committed
  a870b01

  Copy full SHA for a870b01

• Drop "new" qualifier on requirement to allow developers to run their own binaries

  Show description for 65f5148
  joshtriplett

  committed
  65f5148

  Copy full SHA for 65f5148

• Simplify language about developers running their own binaries

  joshtriplett

  committed
  71ce094

  Copy full SHA for 71ce094

• Ensure that developers can give binaries to others, as well

  joshtriplett

  committed
  548de23

  Copy full SHA for 548de23

• Document availability requirements for CI and non-CI resources

  joshtriplett

  committed
  d6c6f1f

  Copy full SHA for d6c6f1f

• Expand target maintainer team size for tier 1

  joshtriplett

  committed
  c1f669b

  Copy full SHA for c1f669b

• Change "their documentation" to just "documentation"

  Show description for 376adda
  joshtriplett

  committed
  376adda

  Copy full SHA for 376adda

• Change "may" to "should" in note that we should audit existing targets

  joshtriplett

  committed
  39e3299

  Copy full SHA for 39e3299

• Expand text about auditing existing targets

  joshtriplett

  committed
  f21ed77

  Copy full SHA for f21ed77

• Change "long-term viability" to just "viability", and combine with "value"

  joshtriplett

  committed
  f6d1a37

  Copy full SHA for f6d1a37

• Expand discussion about documenting subjective requirements

  joshtriplett

  committed
  d747f54

  Copy full SHA for d747f54

• For communications, add "whether the target has been part of a stable release"

  Show description for 919da1a
  joshtriplett

  committed
  919da1a

  Copy full SHA for 919da1a

• Add some discussion about target tier stability guarantees

  joshtriplett

  committed
  8fb49e1

  Copy full SHA for 8fb49e1

Commits on Apr 5, 2021

• Make C interoperability a "must" at tier 2

  Show description for 40ed9f8
  joshtriplett

  committed
  40ed9f8

  Copy full SHA for 40ed9f8

Commits on Apr 6, 2021

• Add an exception allowing non-implementation of std in specific cases

  Show description for c394f76
  joshtriplett

  committed
  c394f76

  Copy full SHA for c394f76

• Add a missing "tier 3" qualifier on a tier 3 requirement

  Show description for da764cd
  joshtriplett

  committed
  da764cd

  Copy full SHA for da764cd

Commits on Apr 7, 2021

• Clarify that infra is not personally responsible for signing legal agreements

  joshtriplett

  committed
  9f793b9

  Copy full SHA for 9f793b9

• Update URL for platform support page

  joshtriplett

  committed
  8e3e9c3

  Copy full SHA for 8e3e9c3

• Promotion/demotion doesn't typically affect past releases

  joshtriplett

  committed
  0ee5875

  Copy full SHA for 0ee5875

• Qualify mentions of CI to include all components Rust's CI considers mandatory

  joshtriplett

  committed
  bf5f44e

  Copy full SHA for bf5f44e

• Clarify the work associated with tier 2 and tier 1 targets

  Show description for d13349e
  joshtriplett

  committed
  d13349e

  Copy full SHA for d13349e

Commits on Apr 14, 2021

• Clarify use of issues to track requirements

  Show description for 1979ced
  joshtriplett

  committed
  1979ced

  Copy full SHA for 1979ced

• Document that raising baselines should be widely communicated

  joshtriplett

  committed
  ac31771

  Copy full SHA for ac31771

Commits on Apr 18, 2021

• Don't hardcode the path to one source file in tidy

  Show description for 7c1b640
  joshtriplett

  committed
  7c1b640

  Copy full SHA for 7c1b640