Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-21339

Redundant descriptions of storage filesystems on developer.lsst.io

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: To Do
    • Resolution: Unresolved
    • Fix Version/s: None
    • Component/s: Documentation
    • Labels:
      None
    • Team:
      Data Facility

      Description

      These two files on https://developer.lsst.io/ :

      contain strongly redundant content which will be difficult to keep in sync and, even if in sync, make readers worry that it might not be. The two pages are very close together in the developer.lsst.io sidebar, so it's not even a case of copying information to an otherwise not-very-closely-related document for user convenience.

      The second file/page seems somewhat more complete and attractively formatted; perhaps a refactoring could emphasize that part?

      Some of this information is partially redundant with nb.lsst.io content, but that redundancy is appropriate, because nb.lsst.io is meant to describe the cloud-based pop-up LSPs as well as the NCSA-hosted ones. However, after a refactoring of these developer.lsst.io pages, I'd like to add links back and forth between them and nb.lsst.io, for clarity.

      I have a feeling that there's yet another list of top-level directories elsewhere in our documentation, but I can't find it right now.

      (Re-created as a JIRA ticket from https://github.com/lsst-dm/dm_dev_guide/issues/343 .)

        Attachments

          Activity

          There are no comments yet on this issue.

            People

            Assignee:
            Unassigned Unassigned
            Reporter:
            gpdf Gregory Dubois-Felsmann
            Watchers:
            Bill Glick [X] (Inactive), Gregory Dubois-Felsmann
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Dates

              Created:
              Updated:

                Jenkins

                No builds found.