1 / 6

Document Versioning

Document Versioning. Milt Panas May 10, 2011. JPSS CGS Form J-110 10/22/2010. Issue Description. Issue – Data Product Document Versioning Description For Data products archived in CLASS, can the product format documentation be easily retrieved years after the product was created? Example

enan
Download Presentation

Document Versioning

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Document Versioning Milt Panas May 10, 2011 JPSS CGS Form J-110 10/22/2010

  2. Issue Description • Issue – Data Product Document Versioning • Description • For Data products archived in CLASS, can the product format documentation be easily retrieved years after the product was created? • Example • Let's say an SST product for a particular day (e.g. Jan 1, 2012) was generated using Mx5 and archived in CLASS. Ten years later, the SST algorithm and associated format documents (CDFCB-X) have been updated 3 times, but someone goes back and retrieves the SST from Jan 1, 2012. The current CDFCB-X doesn't describe the Mx5 version of the SST. Can the Mx5 version of the CDFCB-X be easily identified and retrieved.

  3. Response • Data Product Metadata • N_Software_Version - Version of IDPS software that created the Data Product. • <Identifier><Phase>.<Major>.<Minor>.<Patch> Example: I1.5.01.00 • N_Algorithm_Version - Indicates the version number of the algorithm • <Phase_ID>.<Category_ID>.<Science Baseline ID>.<Software ID> Example: 1.O.001.002 • Version Description Document (VDD) • Based on Software version • Example: VD7620529-1-10 I1.5.04.00A IDPS SW NPP OPS VDD.docx • N_Algorithm_Version is listed in the VDD • Release Packages • Created based on Software Version (same as N_Software_Version) • Contains Software and Documentation (except ITAR and FOUO) • Archived in CLASS • Use the Software Version number to find the Documentation in CLASS

  4. Related Issue Description • Issue – Updates to previously released Documents • Description • For Data products archived in CLASS, can the product format documentation be easily Updated years after the product/Documentation were created if an error is found? • Example • Previous example SST product for a particular day (e.g. Jan 1, 2012) was generated using Mx5 and archived in CLASS. Ten years later, an error is found in the associated format documents (CDFCB-X). Can the Mx5 version of the CDFCB-X be easily updated.

  5. Response • No existing process for this • Possible solution • Revision update and re-release • Update the old revision (e.g. Rev A) of the CDFCB-X to make the update. Number the revision to indicate its an update (e.g. Rev A.1) • Release packages have a versioning mechanism for updates to the package (-n) • Example • Software Release package I1.5.01.00-1 has Rev A of the CDFCB-X. Ten years later, we find an error in the CDFCB-X that needs to be fixed. • Update CDFCB-X to Revision A.1 • Update the Document VDD in the Release package • Update the SW Release package as I1.5.01.00-2 containing the CDFCB-X Rev A.1 • Updated Release package is archived in CLASS (this needs to be worked) • Use the same Software Version number to find the updated Documentation in CLASS

More Related