Update doc/ directory for sphinx

doc/.gitignore

@@ -0,0 +1,10 @@
+# Doxygen products
+html
+xml
+*.tag
+*.inc
+doxygen.conf
+
+# Sphinx products
+_build
+py-api

doc/conf.py

@@ -0,0 +1,13 @@
+"""Sphinx configuration file for an LSST stack package.
+
+This configuration only affects single-package Sphinx documenation builds.
+"""
+
+from documenteer.sphinxconfig.stackconf import build_package_configs
+import lsst.obs.sdss
+
+
+_g = globals()
+_g.update(build_package_configs(
+    project_name='obs_sdss',
+    version=lsst.obs.sdss.version.__version__))

doc/index.rst

@@ -0,0 +1,13 @@
+##############################
+obs_sdss documentation preview
+##############################
+
+.. This page is for local development only. It isn't published to pipelines.lsst.io.
+
+.. Link the index pages of package and module documentation directions (listed in manifest.yaml).
+
+.. toctree::
+   :maxdepth: 1
+
+   obs_sdss/index
+   lsst.obs.sdss/index

doc/lsst.obs.sdss/index.rst

@@ -0,0 +1,14 @@
+.. _lsst.obs.sdss:
+
+#############
+lsst.obs.sdss
+#############
+
+.. Paragraph that describes what this Python module does and links to related modules and frameworks.
+
+.. Add subsections with toctree to individual topic pages.
+
+Python API reference
+====================
+
+.. .. automodapi:: lsst.obs.sdss

doc/manifest.yaml

@@ -0,0 +1,15 @@
+# Documentation manifest.
+
+# Name of this package
+# Also the name of the package documentation subdirectory.
+package: "obs_sdss"
+
+# List of names of Python modules in this package.
+# For each module there is a corresponding module doc subdirectory.
+modules:
+  - "lsst.obs.sdss"
+
+# Name of the static content directories (subdirectories of `_static`).
+# Static content directories are usually named after the package.
+statics:
+  - "_static/obs_sdss"

doc/obs_sdss/index.rst

@@ -0,0 +1,27 @@
+.. _obs_sdss-package:
+
+.. Title is the EUPS package name
+
+########
+obs_sdss
+########
+
+.. Add a sentence/short paragraph describing what the package is for.
+
+The ``obs_sdss`` package provides camera descriptions and metadata for LSST DM to operate with Sloan Digital Sky Survey imaging data.
+
+Project info
+============
+
+Repository
+   https://github.com/lsst/obs_sdss
+
+JIRA component
+   `obs_sdss <https://jira.lsstcorp.org/issues/?jql=project%20%3D%20DM%20AND%20component%20%3D%20obs_sdss>`_
+
+Modules
+=======
+
+.. Link to Python module landing pages (same as in manifest.yaml)
+
+- :ref:`lsst.obs.sdss <lsst.obs.sdss>`