Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

The purpose of an OpenMBEE Enhancement Proposal (OEP) is to manage the process of introducing any major change to OpenMBEE. This is required in order to balance the need to support new features, use cases, and system engineering requirements surrounding product direction.

This document walks you through the six stages of the OEP lifecycle.

...

Info

Prerequisites

  1. Join the OpenMBEE Slack Channel

  2. Join the OpenMBEE Google Group

If you have trouble accessing any of the above, contact openmbee [at] gmail [dot] com

Image Added

Step 1 - Discuss

Most proposals start with an idea. If you have an idea of how OpenMBEE could improve, we encourage you to send an email to openmbee [at] googlegroups [dot] com with a subject starting with [OEP DISCUSS]. This email thread will allow you to gather early feedback. We encourage you to start a Draft document on this wiki or share a Google Document with the mailing list detailing your proposal. Use the draft OEP template below to provide details on your proposal.

Step 2 - Draft

Anyone is welcome to propose a new improvement to OpenMBEE. You will need to request edit access to the Confluence page in order to create your OEP document. You can do so by sending an email with details to openmbee [at] gmail [dot] com and request permission.

Create from Template
spaceKeyOPENMBEE
blueprintModuleCompleteKeycom.atlassian.confluence.plugins.confluence-business-blueprints:all-hands-meeting-blueprint
contentBlueprintId8c60bbe7-b27e-4fae-b76f-bd1ff8450b22
templateName8c60bbe7-b27e-4fae-b76f-bd1ff8450b22685703208
titleOEP-X Enter Descriptive Title
templateId685703208
buttonLabelCreate New Draft OEP

Info

For an example of a well documented proposal, see https://cwiki.apache.org/confluence/display/AIRFLOW/AIP-44+Airflow+Internal+API

Step 3 - Review

Once you or someone else feels like there’s a rough consensus on the idea and there’s no strong opposition, you can move your proposal to the review phase. For this you will send a new email to openmbee [at] googlegroups [dot] com with the subject starting with [OEP REVIEW REQUEST]. In your [OEP REVIEW REQUEST] email please include links to

...

If you want to introduce significant changes to your proposal after it has been accepted you can do so following the same procedure.

Step 4 - Accepted

🥳 Congratulations! 🥳

Your proposal has been accepted. Next up is breaking down tasks. You should break down tasks on one or more of the OpenMBEE repository issue trackers. You are strongly advised to group the tasks together in a Github Project if it consists of multiple steps and you want to be able to track progress for its implementation or share the progress with others. Once issues are created, it helps if you can tag them with the relevant OEP-Xlabel for your OEP. If you need help with this then you can contact an existing OpenMBEE developer.

Now you can start contributing and - more importantly - you can encourage others to contribute to your OEP. You can learn how to contribute and communicate by reading the Contributing guide in the OpenMBEE GitHub Organization. Use your imagination and various communication channels for ways to encourage people if you do not already have contributors following your idea. It is advisable that several people work on the OEP so that the knowledge is shared.

Step 5 - Completed

You should move your OEP to complete after you consider the main bulk of work has been merged to the repository. It is okay to leave open issues for minor follow up tasks like adding additional capabilities or similar. 

Step 6 - Abandoned

An OEP may be moved to abandoned if

...