===== Process for adopting CDM/Vocabulary changes =====

===Discussing proposals==

Proposals are discussed either:
  - on the [[https://github.com/OHDSI/CommonDataModel/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3AProposal%20|github issue site]]
  - during the [[http://www.ohdsi.org/web/wiki/doku.php?id=projects:workgroups:cdm-wg|workgroup meetings]] 
  - or on the [[http://forums.ohdsi.org/c/cdm-builders/|OHDSI Forum for CDM Builders]]

===Submitting proposals===

Proposals were previously submitted at the [[documentation:next_cdm|CDM and Vocabulary Development]]. From **7/11/2017** forward they are submitted as issues on the CDM [[https://github.com/OHDSI/CommonDataModel/issues|github]]

Every proposal needs:  
  * An owner
  * Details
  * Use cases, analytical questions
  * Exploration of the state of the field, other implementations-       
  * Importance, also with respect to other projects
  * Consequences of doing it and not doing it including technical (e.g. implications on vocab, existing software), resources

**Github issues are written in a form of markdown different from this wiki so please use {{:documentation:next_cdm:proposal_template.docx|this template}} as a guide.** 

===Vetting proposals===

Proposals are vetted by a group of experts. 

If not ready it is returned back to discussion.

Results of vetting:
  * Impact
  * Priority/Need or not needed
  * Alternative solution
  * Whether it is a Minor or Major release, or Experimental to be reassessed


===Accepting proposals===
  * At [[http://www.ohdsi.org/web/wiki/doku.php?id=projects:workgroups:cdm-wg|workgroup meetings]] by a majority vote
  * Determine time of release

===Implementation and release===
  * The change should be accompanied by documentation and conventions including use cases 
  * The change should be demonstrated to the community