VG_2803 validation comments from PDS/CN

Last date this file edited - 20040624-1554/SLA

 

1.   \ROOT\AAREADME.TXT

 

     A.   line 36, change:

    

     of computer systems (e.g. Sun, HP, Macintosh, PC). For further

 

                   to:

             

     of computer systems (e.g., Sun, HP, Macintosh, PC). For further

 

         (my little "pet project", proper usage of exempli gratia

         and id est)

Done.

     B.   line 83, HTML link invalid.  Change to:

 

         http://pds.jpl.nasa.gov/documents/sr/index.html

 

              or the more general:

 

         http://pds.jpl.nasa.gov/documents/

Done.

     C.   line 137, HTML link is invalid.  Change to:

 

         http://pds-naif.jpl.nasa.gov/

Done.

     D.   lines 210-223, ASCII representation of directory structure.

 

         Not all of the subdirectories you list here are on the

         volume and there are some subdirectories on the volume

         that are not listed.  Edit the file to more accurately

         represent the volume.

 

         (If light of above, upon further investigation, I think I

         figured out what you did.  If I were you, just duplicate

         the U_RINGS directory structure and paste it under the

         S_RINGS directory; then edit to represent actual.)

 

Done.

 

 

2.   \ROOT\ERRATA.TXT

 

     A.   line 21, change: ...words, e.g.

                   to: ...words, e.g.,

Done.

     B.   End of file.  Just another one of my "pet projects".  I

         often wonder when reading a ERRATA.TXT file if part of the

         file got cut off.  There is no definitive terminator to

         let a reader know that s/he arrived at the end of the file.

         I've really wondered this when reading some ERRATA.TXT

Done.      files that have all the header "stuff", then a header

         beginning the sections of "known errors or deviations",

         then, just a blank line before the end of the file.

         So . . . I like to add <eof> on the last line.  Just like

         this file.  Your choice.  Of course, not required or even

         a recommendation of CN or PDS.

 

3.   \ROOT\VOLDESC.CAT

 

     A.   no issues, looks okay

 

         Note: since we already ingested the VOLDESC and the other

         catalog files, I just made a quick cursory check of them.

 

4.   \DOCUMENT\

 

     A.   ATLAS.PDF and ATLNOTES.PDF

 

         PDS standards require ASCII versions of all document files.

         (Between you and I, and don't tell anyone else here at CN,

         just make a notation in the ERRATA.TXT that ASCII versions

         of these two files are not available, not practical to

         convert, etc. and leave them as is.  Maybe give a link to

         a PDF reader that can be downloaded, but then, there is the

         issue of NASA endorsing a commercial product.)

Done.

         (Update after viewing the above two files.  ATLAS.PDF

         cannot be converted to ASCII text.  But, then the argument

         can be made about converting them to an image of some type,

         such as GIF or JPG.  An case can be made for providing an

         ASCII version of ATLNOTES.PDF, but the math formulas would

         have to be address some how.  My recommendations is as

         above, (i.e., make a notation in the ERRATA.TXT and leave

         them as is).)

 

For Items B. & C. below, I corrected the errors in the attached labels, but did not modify the contents of the documents since they were not authored at the Rings Node.

     B.   RS1S_DOC.TXT

 

         1.   lines 15-18, 'N/A'???

        

              Didn't this come up on VG_2802.  What did you

              decide to do? I think you said that you agreed this

              was old notation, but not technically wrong and

              that for new volumes, you will use quotes instead

              of apostrophies.

 

         2.   lines 104 and 119, add a comma after id est

              use    i.e.,    instead of    i.e.

 

         3.   line 651, lower case exempli gratia and add comma

              use    e.g.,    instead of    E.g.

 

         4.   line 109, double occurance of "the", delete one of

              them.

 

         5.   line 269, capitalize "ascii"

    

     C.   RS2S_DOC.TXT, RS3S_DOC.TXT, and RS4S_DOC.TXT

 

         1.   Same three issues as above in the RS1S_DOC.TXT

              file, (except the line numbers are a little

              different on two of the files).

 

         2.   RS4S_DOC.TXT

 

              a.   line 106, double occurance of "the", delete

                  one.

 

              b.   line 273, capitalize "ascii"

 

         3.   RS3S_DOC.TXT

 

              a.   as above (4.C.3.a.)

 

              b.   as above (4.C.3.b.), but line number 277

 

         4.   RS2S_DOC.TXT

 

              a.   as above (4.C.3.a.), but line number 109

 

              b.   as above (4.C.3.b.), but line number 268

     D.   TUTORIAL.TXT

 

         1.   line 63, id est again

 

         2.   line 251, hyperlink invalid (see 1.C. above for

              correct link)

 

         3.   lines 572-575, and line 621, 'N/A' again

 

         4.   line 660, hyperlink invalid (see 1.B. above for

              correct link)

 

         5.   line 895, illegal æ ASCII characters on this line

Done.

 

     E.   POLES.TXT

 

         1.   line 93, change: etal's

                       to: et al's

I did not modify the body of the document since it was not authored at the Rings Node.

 

5.   \INDEX\

 

     A.   INDEX.LBL

 

         1.   line 61, change: BYTES = 6

                        to: BYTES = 12

 

         2.   line 113, change: BYTES = 16

                        to: BYTES = 15

 

         (start byte counts are correct, just the width of the two

         fields mentioned above)

Done.

 

6.   NOTE: Didn't spend much time with your data directories.  They've

     been pretty clean on your prev VG_xxxx volumes, so spent my limited

     time on label verification and keyword/value pair validation.

 

7.  

 

<eof>