🙋 Documentation Request
The CONTRIBUTOR.md file should include directions on how to include an experimental feature/change which has potential to make it into a stable release as a replacement or a new feature.
💁 Possible Solution
When a new feature/replacement is proposed we should document:
- Including it on a separate export path (if possible)
- Use the
@experiemental tag in the comment block
- Include a comprehensive description
- Add a link to an issue such as an
@see on details about the feature/change (check TSDocs) for details
- The issue should live in
vNext milestone if it is slated for the next major release
- Understanding that the process means that all
@experimental tags will be evaluated during the planning of major releases
- No
@experimental addition should be created without there being an existing GitHub issue
🙋 Documentation Request
The
CONTRIBUTOR.mdfile should include directions on how to include an experimental feature/change which has potential to make it into a stable release as a replacement or a new feature.💁 Possible Solution
When a new feature/replacement is proposed we should document:
@experiementaltag in the comment block@seeon details about the feature/change (check TSDocs) for detailsvNextmilestone if it is slated for the next major release@experimentaltags will be evaluated during the planning of major releases@experimentaladdition should be created without there being an existing GitHub issue