MIP-53: Conventions for Proposing Progressive L2 Models
- Description: Introduces conventions for proposing progressive L2 models.
- Authors: Liam Monninger
- Reviewer: Andreas Penzkofer
- Desiderata:
Abstract
Movement’s L2 system will progress through various changes during its life, and each stage is presented through a new L2 model (which we call progressive L2 model). Thus a given progressive L2 model describes as a particular stage in the evolution of the L2 system. A given progressive L2 model stage is defined through the sum of its improvements and it may encompass components that are not directly related to each other.
We propose a set of conventions including naming, formatting, and related standards to assist reviewing proposals for said models. Finally a collection point of these terms to provide an overview
Motivation
In order to facilitate the development of L2 systems, it is important to have a clear and consistent way to propose and review models for these systems. This MIP aims to provide a set of conventions for proposing progressive L2 models that will help to ensure that proposals are clear, consistent, and easy to review.
Specification
Progressive L2 models should adhere to conventions of the following forms:
- naming: apply a standard naming format.
- acknowledgement of standards: acknowledge the conventions of this MIP.
- summary table: a table succinctly noting key features of the model.
- statement towards progression: a statement of how the model suits a progressive approach to L2 design and release.
- pros and cons: a list of pros and cons.
Naming
All proposed progressive L2 models MUST adopt a name of the form “The [Location] Model” where [Location] is a location where the proposal was drafted or a similarly symbolic location. This name should be the title of the associated MIP.
In text, the model SHOULD be referred to as “[Location] Model,” that is, the name of the model in title case.
Acknowledgement of Standards
At the start of the “Specification” section of the MIP, the author MUST include the following markdown snippet:
We acknowledge and apply the conventions of [MIP-53: Conventions for Proposing Progressive L2 Models](../mip-53/).
Summary Table
All proposed progressive L2 models MUST complete the following table:
| Category | Criterion | Evaluation |
|---|---|---|
| General | ||
| X | When to use | A brief general description of the circumstances under which the model is appropriate. |
| X | Suitable preceding models | A list of models or descriptions of models that are suitable precursors to this model. |
| X | Suitable succeeding models | A list of models or descriptions of models that are suitable successors to this model. |
| X | Technological motivations | A brief description of the technological motivations for using the model. |
| X | Usership motivations | A brief description of the user motivations for using the model. |
| Components | ||
| X | Component Name 1 | A description of usage of said component. |
| X | Component Name 2 | A description of usage of said component. |
Statement Towards Progression
All proposed progressive L2 models MUST include a statement of how the model suits a progressive approach to L2 design and release. This statement SHOULD be a paragraph in length and immediately follow the summary table–as if it were a caption for the table.
Pros and Cons
All proposed progressive L2 models MUST include a list of pros and cons. This list SHOULD be formatted as two separate bulleted lists in subsections titled “Pros” and “Cons.”