[Sea-sa] Rough minutes from the 13 Feb 23 SEA SAWG RASDS telecon

Wed Feb 15 01:47:42 UTC 2023

Dear SEA SAWG members, RASDS subset,

We held a telecon on 13 Feb 23.  Here are the rough minutes.

Attendees: Ramon Krosley, Shelbun Cheng, Faramaz Davarian, Christian Stangl, Peter Shames

  *   We agreed to try using the CCSDS Sharepoint on-line editing capability to help eliminate some of the versioning issues (see later notes for some comments on that)
  *   The team agreed that they liked the graphic from Voyager Neptune as a visual describing “viewpoints”
  *   We discussed the use of the new term “derived viewpoints” in re the new Physical Viewpoint and the derived Connectivity and Structural Viewpoints.  We agreed to adopt this approach and fit the materials into it.  The use of Correspondence appears to be powerful enough to do what we need and to provide a framework for other derived extensions.
  *   We agreed to try and create a “UML-like” diagram of the viewpoints and derived viewpoints for sec 2.1.  Shelbun has taken that as an action item.
  *   We discussed the use of the terms Component and Connector in the Physical Viewpoint and their correspondence to the Node and Link terms used in the derived Connectivity Viewpoint.   The notion of correspondence works to cover these terminology mappings too.  We believe that the same should be true of mapping into a new, as yet unspecified, derived, Thermal Viewpoint with mapping of Connector, in that case, to “Thermal Flow”.
  *   Agreed to use something like an RTG connected to the body of a spacecraft bus as a Structural VP example.
  *   We discussed the distinction between architectural representations and engineering representations.  That is one of the core foci of this document and it needs to be made even more crisp.
  *   As part of this discussion, we agreed to move the current Sec 2.10 and 2.11 to earlier in the document, after the Sec 2.2 intro.  Exact location TBD.
  *   We reviewed Fred’s new draft Service Viewpoint text.  Discussed the distinctions between “services”, which may be of many forms, including internal ones, and the formal Services that we are treating, formally offered Services at the interface of a system.  As an analog, these may appear in a Service Catalog, in some ways that is just what the tabular form at the heart of the Viewpoint is intended to address.
  *   There were some other concerns about proposed use of terminology in the new Services VP, but these will be addressed in the next meeting when Fred is present.

Follow-up Notes:

  *   The latest version of the document, 311x0p2 RASDS++ Draft 13Feb23, is now updated in the RASDS 2020 Revisions working documents, located in the CWE at: https://cwe.ccsds.org/sea/docs/Forms/AllItems.aspx?RootFolder=%2Fsea%2Fdocs%2FSEA%2DSA%2FDraft%20Documents%2FRASDS%20Revisions%202020%2FRASDS%20revisions%20draft%20documents&FolderCTID=0x012000F83FD93BEFF45E4FB5D1769B01CA762F&View=%7BA709F322%2D0E67%2D45C7%2D932D%2DCB78C55CE268%7D
  *   The current version of the document includes Fred’s Services Viewpoint, merged into the document as a new section 9.
  *   The old section 2.10 and 2.11 are now sections 2.2 and 2.1 to provide an introduction to modeling and viewpoints early in the document.  Some “smoothing” may be needed to get the flow right.

Use of Sharepoint as an editing tool:

  *   I tried to use Sharepoint on-line to merge in Fred’s new Services section and that was a dismal failure, Sharepoint cannot handle it and trying to edit that sort of large chunk of text seems intractable.
  *   At the same time, trying to do the same thing in Word was also problematic, I wound up manually creating new section headings and doing a copy / paste, section by section, in Word.
  *   For the record, here are other notes from this on-line editing session:
     *   Tried to open doc in Sharepoint, took 15 seconds to open
     *   Tried to use “accessibility mode”, blew up with error message
     *   Tried to cut / paste sec 2.11, “Sorry, Word online cannot cut this section”
     *   Was able to select and copy text and then go back and delete original section.
     *   Minor edits worked just fine and all edits, including flawed ones, were preserved.
     *   Seems that online Word has a mind of it’s own, it jumps back to the start of the document all by itself, a lot.
     *   Figures behave weirdly, show up cropped on-line until you select them and stretch the borders so they can be seen.
        *   Back in regular Word these figures are then stretched outside the normal boundaries and have to be adjusted again.
     *   Renumbering of sections gets screwed up sometimes
     *   I could not figure out how to add new sections with new section number on-line, in the regular Word there is just a menu item to do it
  *   My conclusion is that this on-line editing in Sharepoint may be useful for simultaneous edits that are modest in nature.
  *   It should be possible to insert new text, make modest changes to text, and to use a sort of “Copy / Paste / Delete” process to move chunks of text around in the body of the document
  *   Based on this limited trial I think it worthwhile to continue to try and use it for our purposes, but for major edits, insertion of new sections and figures, etc, I think we had best resort to downloading a copy, making these edits, and then uploading a new version.
  *   It may be that the “Document Checkout” feature will work to help manage CM control (see screenshot), I have not tried that.
  *   If someone has experience with this feature please inform us if, and how well, it works.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.ccsds.org/pipermail/sea-sa/attachments/20230215/0bd5656a/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: RASDS edits in Sharepoint 2023-02-14.pdf
Type: application/pdf
Size: 712722 bytes
Desc: RASDS edits in Sharepoint 2023-02-14.pdf
URL: <http://mailman.ccsds.org/pipermail/sea-sa/attachments/20230215/0bd5656a/attachment-0001.pdf>