# LDM-129 -135 -152 and -230 DM Design Documents now available as websites

**URL:** <https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354>\
**Category:** DM Notifications\
**Created:** [November 3, 2015, 9:31pm UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354 "2015-11-03T21:31:30Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![jsick](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/jsick/32/672_2.png) [@jsick](https://www.rubin.community/u/jsick)\
**Post date:** [November 3, 2015, 9:31pm UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354/1 "2015-11-03T21:31:30Z")

</div>

As part of a greater strategy(\*) to improve DM’s documentation, we have begun to transition some of DM’s change-controlled documents out of their Word and LibreOffice source forms and into GitHub-backed reStructuredText documents that are continuously distributed to the web.

Documents currently available are:

- [LDM-129: Data Management Infrastructure Design](http://ldm-129.readthedocs.org/en/master/). Source on [GitHub](https://github.com/lsst/ldm-129).
- [LDM-135: Data Management Database Design](http://ldm-135.readthedocs.org/en/master/). Source on [GitHub](https://github.com/lsst/ldm-135).
- [LDM-152: Data Management Middleware Design](http://ldm-152.readthedocs.org/en/master/). Source on [GitHub](https://github.com/lsst/ldm-152).
- [LDM-230: Automated Operations of the LSST Data Management System](http://ldm-230.readthedocs.org/en/master/). Source on [GitHub](https://github.com/lsst/ldm-230).

Please note that the _official_ versions of these documents reside in LSST’s Docushare repository. When these GitHub-backed documents are updated and approved, a new official version will be deposited in Docushare.

(\*) I plan to write a proposed strategy soon.

---

<div class="post-metadata">

**Author:** ![frossie](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/frossie/32/9_2.png) [@frossie](https://www.rubin.community/u/frossie)\
**Post date:** [November 4, 2015, 8:05am UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354/2 "2015-11-04T08:05:43Z")

</div>

I just want to say, looks great.

---

<div class="post-metadata">

**Author:** ![FabioHernandez](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/fabiohernandez/32/82_2.png) [@FabioHernandez](https://www.rubin.community/u/FabioHernandez)\
**Post date:** [November 4, 2015, 4:36pm UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354/3 "2015-11-04T16:36:23Z")

</div>

This is very useful: the documents are much more easily accessible than using docushare and they look great.

I would suggest to make a document index which would be the portal to easily find any of those documents.

---

<div class="post-metadata">

**Author:** ![jsick](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/jsick/32/672_2.png) [@jsick](https://www.rubin.community/u/jsick)\
**Post date:** [November 4, 2015, 4:39pm UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354/4 "2015-11-04T16:39:15Z")

</div>

> [@FabioHernandez](#):
>
> I would suggest to make a document index

👍

I’ll add that there’s a [Confluence page indexing design documents](https://confluence.lsstcorp.org/display/DM/Requirements+and+Design+Hierarchy). My plan is to make design documents more visible from a new [dm.lsst.org](http://dm.lsst.org) rather than being buried in Confluence.

---

<div class="post-metadata">

**Author:** ![ktl](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/ktl/32/1373_2.png) [@ktl](https://www.rubin.community/u/ktl)\
**Post date:** [November 4, 2015, 4:41pm UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354/5 "2015-11-04T16:41:16Z")

</div>

> [@FabioHernandez](#):
>
> the documents are much more easily accessible than using docushare

We should make sure that the canonical versions (which these actually are) are given release numbers and marked as such while master is marked as an unofficial draft only.

---

<div class="post-metadata">

**Author:** ![jsick](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/jsick/32/672_2.png) [@jsick](https://www.rubin.community/u/jsick)\
**Post date:** [November 4, 2015, 4:45pm UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354/6 "2015-11-04T16:45:52Z")

</div>

I could add some annotations to the Sphinx theme.

We can have readthedocs build ‘release’ branches; those could be annotated as official on the webpage, whereas the master is marked as an unofficial draft.

Should the pages also point to the deposition in Docushare (i.e., a link near the top)? I guess the officially sanctioned versions will be printed to PDF and put in docushare?

---

<div class="post-metadata">

**Author:** ![ktl](https://sea2.discourse-cdn.com/flex002/user_avatar/www.rubin.community/ktl/32/1373_2.png) [@ktl](https://www.rubin.community/u/ktl)\
**Post date:** [November 4, 2015, 5:50pm UTC](https://www.rubin.community/t/ldm-129-135-152-and-230-dm-design-documents-now-available-as-websites/354/7 "2015-11-04T17:50:08Z")

</div>

All of the above sounds great. No rush.
