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/ :
- https://github.com/lsst-dm/dm_dev_guide/blob/master/services/ldf-resources.rst
- https://github.com/lsst-dm/dm_dev_guide/blob/master/services/storage.rst
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 .)