Back to React Spectrum

(RFC title goes here)

rfcs/template.md

2022-12-163.3 KB
Original Source
<!-- Copyright 2020 Adobe. All rights reserved. This file is licensed to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->
  • Start Date: (fill me in with today's date, YYYY-MM-DD)
  • RFC PR: (leave this empty, to be filled in later)
  • Authors: (the names of everyone contributing to this RFC)

(RFC title goes here)

Summary

<!-- One-paragraph explanation of the feature. -->

Motivation

<!-- Why are we doing this? What use cases does it support? What is the expected outcome? -->

Detailed Design

<!-- This is the bulk of the RFC. Explain the design with enough detail that someone familiar with React-Spectrum can implement it by reading this document. Please get into specifics of your approach, corner cases, and examples of how the change will be used. Be sure to define any new terms in this section. -->

Documentation

<!-- How will this RFC be documented? Does it need a formal announcement to explain the motivation? -->

Drawbacks

<!-- Why should we *not* do this? Consider why adding this into React-Spectrum might not benefit the project or the community. Attempt to think about any opposing viewpoints that reviewers might bring up. Any change has potential downsides, including increased maintenance burden, incompatibility with other tools, breaking existing user experience, etc. Try to identify as many potential problems with implementing this RFC as possible. -->

Backwards Compatibility Analysis

<!-- How does this change affect existing React-Spectrum users? Will any behavior change for them? If so, how are you going to minimize the disruption to existing users? -->

Alternatives

<!-- What other designs did you consider? Why did you decide against those? This section should also include prior art, such as whether similar projects have already implemented a similar feature. -->

Open Questions

<!-- This section is optional, but is suggested for a first draft. What parts of this proposal are you unclear about? What do you need to know before you can finalize this RFC? List the questions that you'd like reviewers to focus on. When you've received the answers and updated the design to reflect them, you can remove this section. -->

Help Needed

<!-- This section is optional. Are you able to implement this RFC on your own? If not, what kind of help would you need from the team? -->

Frequently Asked Questions

<!-- This section is optional but suggested. Try to anticipate points of clarification that might be needed by the people reviewing this RFC. Include those questions and answers in this section. --> <!-- This section is optional but suggested. If there is an issue, pull request, or other URL that provides useful context for this proposal, please include those links here. -->