DAP4: Design Proposal Process

From OPeNDAP Documentation
⧼opendap2-jumptonavigation⧽

James Gallagher

<-- back to OPULS Development

Background

We need a formal process for presenting and discussing proposals for the DAP4 design. It should be easy to use and accommodate the ideas/proposals we already have. It should also provide a way to preserve the important points of the discussions we have regarding the proposed idea. This doesn't mean that the entirety of the discussion should be included, often there is too much noise there to render that kind of material useful several month hence, but the main points should be preserved. Some of the proposals will very likely resolve themselves to tradeoffs where no choice is optimal and it will be very helpful to be able to return to the motivations for our decisions.

Proposed Process

For Design Proposals, I propose these steps:

  1. Anyone can write up a new idea and add it to the wiki. It would be best if the ideas are presented using the following format:
    • Background;
    • Problem addressed;
    • Proposed solution;
    • Rationale for the solution;
    • Discussion
  2. Ideas can be considered as Proposals if the entire group agrees (or at least if there are no people who object).
  3. We will keep the number of proposals actively under discussion to a minimum - ideally just one - but realize that several proposals might be interrelated so discussing then separately could be counter productive.
  4. We will discuss the proposal to determine if it is acceptable. We will use email or an email list for most of the discussion, but the conclusions of the discussion should be captured on the wiki page that contains the proposal.
  5. Proposals can be adopted when we all agree on them, or they can be discarded if we all agree on that.

Notes:

  • I have a very simple template for the ideas at Template:DAP4 Design Proposal. The easiest way to use it is to use the {{subst: DAP4 Design Proposal}} syntax to include the template. We might add to this template over time.
  • If the new wiki pages all start with the prefix DAP4: that will help organize the content and will automatically add all of the pages to the DAP4 category. To explicitly add a page to that, or another, category, use the syntax [[Category:DAP4|<<page name>>]].