LSST DM Developer Guide
This repository contains the content for the LSST DM Developer Guide, https://developer.lsst.io.
Everyone in LSST DM is encouraged to not only use this guide, but also contribute to it. The contribution process is outlined below.
Clone this repository:
git clone https://github.com/lsst-dm/dm_dev_guide && cd dm_dev_guide.
Create a branch. This can either be an informal user branch or a full-fledged ticket branch tracked in JIRA. See the DM Workflow guide for details.
Make and commit your edits. Content is written in reStructuredText. Our reStructuredText Style Guide covers the syntax you'll need.
Push your development branch to GitHub and make a pull request. The pull request page will help you track the publishing and testing status of your branch.
Once you're done, press the green button on your pull request to merge to
master. Your changes are automatically published to the main URL: https://developer.lsst.io. Don't worry about messing things up, GitHub branch protections will ensure that your edits build successfully, and that your branch is up-to-date with
Installing and building these docs locally
Although LSST the Docs will publish your development branch, you might want to build this documentation locally.
Assuming you've cloned the docs (following the guide above):
pip install -r requirements.txt
Compile the HTML by running
The built site is in the
Editing entirely on GitHub
If you're in a hurry, you don't need to worry about cloning the Developer Guide; you can do everything on GitHub.com. See GitHub's documentation on editing files and creating branches entirely from GitHub.com.
Remember to preview your published branch by finding it at https://developer.lsst.io/v (see Step #5 of § Contributing, above).
Copyright 2015-2019 Association of Universities for Research in Astronomy, Inc. (AURA).
LSST DM Developer Guide by Association of Universities for Research in Astronomy, Inc. is licensed under a Creative Commons Attribution 4.0 International License.
Based on a work at https://github.com/lsst_dm/dm_dev_guide.