[Css-csts] updated Errata sheets and posting them on the CWE

Tue Nov 5 22:52:50 UTC 2019

Dear Wolfgang,
Okay, we can start simple (no intermediate hierarchy) and change that if it becomes unmanageable.

We don’t have to make the edits on-line. Instead, we can upload files revised files with the same filename, and SharePoint provides the option to treat the new upload as a new version. We only have to make sure to delete previous versions if the file names change, e.g., to remove Fwd and Rtn prefixes.

While the CWE (SharePoint) will keep the version modification dates straight, I am a bit concerned that once one downloads a file that information is lost and the operating system stamps the file with the date/time of the download. I can see myself getting confused and accidentally working with/updating an older version on my computer and not the latest one on the CWE. I’d like to suggest that in the Status line for every Errata sheet we include a sentence along the line of “This version was generated on <date> by <name of person who updated the file>.” Then if someone has two errata documents with the same name they need only to look at the Status line to know which is the most recent. (Note that the generation date may not necessarily be the same as the date that the file is uploaded to the CWE. )

I have created the Functional Resource Errata Sheets folder within the CWE Functional Resources Definition folder:
https://cwe.ccsds.org/css/docs/CSS-CSTS/CWE%20Private/Functional%20Resources%20Definition/Functional%20Resource%20Errata%20Sheets/

and uploaded the 11 errata sheets that I have updated, with the data stamps and author initials removed from the file names. I also included the generation data in the version information field for each file to provide further traceability. The Version History for any file can be read by clicking on the ellipses (…) next to the file name, and then clicking on the ellipses (…) at the bottom of the box that pops up.

I hope that you find this workable and useful.

Best regards,
John

From: Wolfgang Hell <wo_._he at t-online.de>
Sent: Tuesday, November 05, 2019 9:25 AM
To: John Pietras <john.pietras at gst.com>
Cc: Holger.Dreihahn at esa.int; harald.ernst at esa.int; Pham, Timothy T (3300) <Timothy.T.Pham at jpl.nasa.gov>
Subject: Re: updated Errata sheets and posting them on the CWE

Dear John,

The fact that meanwhile we have so many Errata Sheet files is attributable to the fact that for our convenience each time we changed something we changed the file name so that from that file name the date and editor is obvious. There is however no good reason to keep all the files for the same FR type with an earlier issue date than the latest one because we both kept all items in the file even though they had been closed. I'm advocating to continue doing that because more than once it proved useful to be able to go back and figure out why certain decisions had been taken. That means that there is no reason for an ever growing number of documents, but we only need the most recent errata sheet for each FR type. Given that within the folder I can sort by FR name (classifier) or release date and so far that was all I needed. I'm not opposed to intermediate folders, but I do not see a real need for them.

SharePoint on the CWE may be a good way to go, but I have no experience with working on online copies of files. I would not like to depend on being always online when working on Errata Sheets. But other than that I agree that we should "publish" the Errata Sheets on the CWE.

Best regards,

Wolfgang

Am 04.11.2019 um 17:31 schrieb John Pietras:
CSTSWG colleagues ---
At the Fall 2019 Workshop, we resolved a number of questions/issues regarding various FRs, and Wolfgang and I agreed to update their respective errata sheets. For my part, I initially had 3 errata sheets to update – TCMcMux, TcVcMux, and FCltuTsProvider. There was one issue common to all transfer service provider FRs (related to network and ISP-1 parameter settings), so I updated the errata sheets for those FRs also. Al errata sheets that contain updates that are solely the result of decisions made at the fall meeting carry the date stamp “191024”. However, in updating the errata sheets, I came across a few new issues. Errata sheets that contain these new issues have date stamps of today – 191104. The updated errata sheets are attached.

I think that we briefly discussed putting the errata sheets on the CWE, but I don’t think that we made any specific plans. I propose that they should be uploaded to a new FR Errata Sheets folder in the CWE > Functional Resources Definition folder.  Beyond that, I think that we have 2 decisions to make.

The first decision is whether to just put all of the FR errata sheets directly into the FR Errata Sheets folder, or to introduce in intermediate set of folders. Personally I would like to see an intermediate set of folders, because otherwise we will have a long (and over time, increasingly long) list of documents that will be organized by FR name (classifier). A relatively simple set of intermediate folders could be named for the FR strata: Aperture, Physical Channel, etc. If we choose to go this way (or to use a different set of intermediate folders) I will put those folders into the CWE.

The second decision is on the naming of the errata sheets. So far Wolfgang and I have been including a data stamp and our initials in the names of the files to keep them sorted out. However, by using the SharePoint-based CWE, we have the opportunity to keep just the one copy of the file and perform our updates to the online copy. Wolfgang and I have already established a pattern for labeling our updates with our initial and a data stamp, so traceability of changes shouldn’t be an issue.

I am interested in hearing your comments.

Best regards,
John

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.ccsds.org/pipermail/css-csts/attachments/20191105/05abfc33/attachment-0001.html>