Modifications of the OSEHRA Technical Journal in Light of Recent VA Discussions and Code Uploads

Modifications of the OSEHRA Technical Journal in Light of Recent VA Discussions and Code Uploads

Purpose:

The current OSEHRA Technical Journal (OTJ) submission and certification processes were developed prior to the October 21 face-to-face meeting.  Since that time, we see the emergence of a two phase process with OSEHRA Software Quality Certification preceding and somewhat separate from final acceptance into the VA (or other certifying authority) platinum codebase.  Further, while we had been assuming that most of our initial effort would involve Mumps code, substantial portions of the first several code captures by OSEHRA appear to be non-Mumps (C, Javascript) code.  The purpose of this document is to provide design guidance for refining the OTJ to reflect our new understanding, to support multiple languages and to reflect the emergence of the two Phase approach.

Submission Documents:
  • We need to remove the M-Code developers checklist as a required document.  For Mumps only, this should be kept as optional
Workflow Changes
  • We should allow for different workflows based on language type.
  • We need to differentiate Phase I (OSEHRA Software Quality Certification) from Phase II (VA Code acceptance and inclusion)  The current certification is likely Phase II.  We need to add a Phase I modeled after the Gerrit process.
  • Rework the peer/final reviewer checklist for Phase 1 to have less of a dependence on VA documents.
  • Successful Phase I code should be marked as "Passed OSEHRA Software Quality Certification".  This is potentially a terminal state (i.e. not everything that gets to this point progresses further.)
  • Past Phase 1, opening of the article for additional progress should require an explicit step by an editor.
  • Phase 2 reviews should be missing or grayed out until the article is selected for to progress further.
Cosmetic Changes:Code Upload
  • Investigate the issues with IE and Firefox during code upload.
like0