From 0f9bd40b89237041ff0f054b4720117881925da2 Mon Sep 17 00:00:00 2001 From: Dave Grochocki Date: Fri, 17 May 2019 11:52:02 -0700 Subject: [PATCH] Updating terminology in new feature development process for clarity (#509) --- docs/NewFeatureProcess.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/NewFeatureProcess.md b/docs/NewFeatureProcess.md index 2a84aa27..6f514d00 100644 --- a/docs/NewFeatureProcess.md +++ b/docs/NewFeatureProcess.md @@ -29,26 +29,26 @@ idea until it is ready for review. We review pitches regularly, and will approve or close issues based on whether they broadly align with the [Calculator roadmap](https://github.com/Microsoft/calculator/blob/master/docs/Roadmap.md). Approved pitches are moved -into [pre-production](https://github.com/Microsoft/calculator/projects/1) on the feature tracking board. +into [planning](https://github.com/Microsoft/calculator/projects/1) on the feature tracking board. -## Step 2: Pre-production +## Step 2: Planning For most features, the output of this phase is a specification which describes how the feature will work, supported by design renderings and code prototypes as needed. The original issue will continue to track the overall progress of the feature, but we will create and iterate on spec documentation in the [Calculator Spec repo](https://github.com/Microsoft/calculator-specs). Sometimes we'll learn new things about a feature -proposal during pre-production, and we'll edit or close the original pitch. +proposal during planning, and we'll edit or close the original pitch. -We welcome community participation throughout pre-production. The best ideas often come from trying many ideas during -the pre-production phase. To enable rapid +We welcome community participation throughout planning. The best ideas often come from trying many ideas during +the planning phase. To enable rapid experimentation, we encourage developing and sharing rough ideas—maybe even with pencil and paper—before making designs pixel-perfect or making code robust and maintainable. After the [spec review](https://github.com/Microsoft/calculator-specs#spec-review) is completed, we will move the issue -into [production](https://github.com/Microsoft/calculator/projects/1) on the feature tracking board. In _some_ cases, +into [implementation](https://github.com/Microsoft/calculator/projects/1) on the feature tracking board. In _some_ cases, all of the details of an idea can be captured concisely in original feature pitch. When that happens, we may move ideas -directly into production. +directly into implementation. -## Step 3: Production +## Step 3: Implementation A feature can be implemented by the original submitter, a Microsoft team member, or by other community members. Code contributions and testing help are greatly appreciated. Please let everyone know if you're actively working on a feature to help avoid duplicated efforts from others.