DM-13941 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.pipe.drivers
+
+
+_g = globals()
+_g.update(build_package_configs(
+    project_name='pipe_drivers',
+    version=lsst.pipe.drivers.version.__version__))

doc/index.rst

@@ -0,0 +1,13 @@
+##################################
+pipe_drivers 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
+
+   pipe_drivers/index
+   lsst.pipe.drivers/index

doc/lsst.pipe.drivers/index.rst

@@ -0,0 +1,14 @@
+.. _lsst.pipe.drivers:
+
+#################
+lsst.pipe.drivers
+#################
+
+.. 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.pipe.drivers

doc/manifest.yaml

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

doc/pipe_drivers/index.rst

@@ -0,0 +1,27 @@
+.. _pipe_drivers-package:
+
+.. Title is the EUPS package name
+
+############
+pipe_drivers
+############
+
+.. Add a sentence/short paragraph describing what the package is for.
+
+The ``pipe_drivers`` package provides high level task execution and coordination scripts to allow task parallelization.
+
+Project info
+============
+
+Repository
+   https://github.com/lsst/pipe_drivers
+
+JIRA component
+   `pipe_drivers <https://jira.lsstcorp.org/issues/?jql=project%20%3D%20DM%20AND%20component%20%3D%20pipe_drivers>`_
+
+Modules
+=======
+
+.. Link to Python module landing pages (same as in manifest.yaml)
+
+- :ref:`lsst.pipe.drivers <lsst.pipe.drivers>`