Hi all. Here's another attempt at further simplifying the OEP process, including the submission process and the OEP template:
https://github.com/edx/open-edx-proposals/pull/60 Please review and provide any feedback. *Review Period: *May 02, 2018 -> May 11, 2018 *Motivation* Going forward, we want to encourage teams to write down and propose their architectural and system-wide decisions so we can align with best practices, processes, and system architectures. Our hypothesis is that the rigid structure required by the PEP-based OEP template deters and confuses authors. Also, we find that some authors continue to prefer other documentation and discussion tools. So this PR introduces 2 other OEP templates to accommodate those needs: - ADR-based template (much simpler format than PEP) - External-link catered template (requiring distilled decisions to still be captured in the OEP, but discussions and other details can be captured elsewhere) Thanks, Nimisha On Tue, Feb 6, 2018 at 3:45 PM, Nimisha Asthagiri <[email protected]> wrote: > Hello edx-code, > > *Proposal for Review* > > We would like to simplify the process for creating/maintaining Open edX > Proposals <https://github.com/edx/open-edx-proposals>. Going forward, we > want to lower the barrier for proposing architectural and system-wide > decisions so we can align with edX best practices, processes, and > architectures. > > Additionally, we are updating the process given recent changes in the org > (i.e., the formation of an Architecture team > <https://openedx.atlassian.net/wiki/spaces/AC/pages/439353453/Architecture+Team> > in lieu of a chief architect). > > Please refer to the PR for updating and simplifying OEP-1 > <https://github.com/edx/open-edx-proposals/pull/53>. > > *Note* > > In particular, please notice that a proposed change is that future OEPs > would be announced on slack > <https://github.com/edx/open-edx-proposals/pull/53/files#diff-fe2e3cd15d875e19d9059cb402bb62d6R191> > and may not always be announced on edx-code. So folks who are interested in > architecture proposals can be informed through a more focused channel. > > *Review Feedback* > > You may share your comments/feedback by: > > - posting on the PR <https://github.com/edx/open-edx-proposals/pull/53> > . > - starting a thread on #architecture on slack > <https://openedx.slack.com/messages/C0RU5BTCP/details/>, which we > would eventually record in the OEP PR. > - contacting me or Cale <[email protected]> (the Arbiter of this edit), > with the intent of capturing a summary of the conversation on the PR. > > *Timeline* > > As specified in the PR, the target review end date is Feb 15th > <https://github.com/edx/open-edx-proposals/pull/53/files#diff-fe2e3cd15d875e19d9059cb402bb62d6R26>. > If needed, we will extend the deadline. > > Thanks, > Nimisha (and Cale as "Arbiter") > > -- You received this message because you are subscribed to the Google Groups "General Open edX discussion" group. To view this discussion on the web visit https://groups.google.com/d/msgid/edx-code/CACSOLjcDNUw3sRuHMLFa_QqFWKyi9YETy%2BwL1Kr%2BzAfCFap5iw%40mail.gmail.com.
