Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update guidance on experimental components to call them "incubating" #1249

Merged
merged 10 commits into from
Jun 12, 2023

Conversation

jattasNI
Copy link
Contributor

@jattasNI jattasNI commented May 16, 2023

Pull Request

🤨 Rationale

We had a team discussion about encouraging more Nimble contributions for things like app-specific table columns. This update captures policies for those components in CONTRIBUTING.md

👩‍💻 Implementation

Update the "Experimental" section of CONTRIBUTING.md to call these components "Incubating" and provide more detailed guidance.

Small updates to related documentation about component status and semver.

🧪 Testing

N/A

✅ Checklist

  • I have updated the project documentation to reflect my changes or determined no changes are needed.

@jattasNI jattasNI marked this pull request as ready for review May 16, 2023 20:23
@jattasNI jattasNI requested a review from rajsite as a code owner May 16, 2023 20:23
packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
@jattasNI jattasNI changed the title Update guidance on experimental components Update guidance on experimental components to call them "incubating" May 18, 2023
Copy link
Contributor Author

@jattasNI jattasNI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to use the Incubating terminology and changed some policies in response to reviewer feedback.

packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
packages/nimble-components/CONTRIBUTING.md Outdated Show resolved Hide resolved
@jattasNI jattasNI requested a review from rajsite May 18, 2023 18:05
@jattasNI jattasNI enabled auto-merge (squash) June 12, 2023 14:40
@jattasNI jattasNI merged commit a37e74d into main Jun 12, 2023
@jattasNI jattasNI deleted the experimental-components-contributing branch June 12, 2023 14:55
jattasNI added a commit that referenced this pull request Jun 12, 2023
…rybook (#1292)

# Pull Request

## 🤨 Rationale

Following the guidance agreed upon in #1249, we want to promote the
"Incubating" terminology to describe components that aren't ready for
general use.

## 👩‍💻 Implementation

1. Add sections to Storybook for **Incubating** and **Components**. The
latter was proposed in #1230 so it seems like a good direction for
multiple reasons.
2. Add MDX docs for the Incubating section.
3. Add a link to the corresponding component issue from incubating
stories. Update tooltip to use standard incubating header.
4. Rename WaferMap stories to "Wafer Map" to match other components
which English naming not code naming (and since this change was already
going to cause a Chromatic diff)

## 🧪 Testing

<!---
Detail the testing done to ensure this submission meets requirements. 

Include automated/manual test additions or modifications, testing done
on a local build, private CI run results, and additional testing not
covered by automatic pull request validation.
-->

## ✅ Checklist

<!--- Review the list and put an x in the boxes that apply or ~~strike
through~~ around items that don't (along with an explanation). -->

- [x] I have updated the project documentation to reflect my changes or
determined no changes are needed.

---------

Co-authored-by: Milan Raj <rajsite@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants