From d0af3ce0eefe6f0e0bd83470b0cd61f1a5b07407 Mon Sep 17 00:00:00 2001
From: Wilson Beebe <wbeebe@uw.edu>
Date: Thu, 4 Apr 2024 15:15:59 -0700
Subject: [PATCH] Add contribution guide and first issue badge (#424)

* Add contribution guide and add first issue badge

* Add contribution guide to README

* Remove Dev Guide from README

* Fix code block indentation

* Delete contributions.code-workspace

* Fix code block indent

* remove slow timing comparsion

* Switch to code block bash

---------

Co-authored-by: Doug Branton <brantd@uw.edu>
---
 README.md                            | 17 +++--------------
 docs/gettingstarted.rst              |  3 ++-
 docs/gettingstarted/contributing.rst | 20 ++++++++++++++++++++
 docs/index.rst                       |  1 +
 4 files changed, 26 insertions(+), 15 deletions(-)
 create mode 100644 docs/gettingstarted/contributing.rst

diff --git a/README.md b/README.md
index e6207fcc..d4a84e72 100644
--- a/README.md
+++ b/README.md
@@ -29,22 +29,11 @@ TAPE is available to install with pip, using the "lf-tape" package name:
 pip install lf-tape
 ```
 
-## Getting started - for developers
+## Contributing
 
-Download code and install dependencies in a conda environment. Run unit tests at the end as a verification that the packages are properly installed.
+[![GitHub issue custom search in repo](https://img.shields.io/github/issues-search/lincc-frameworks/tape?color=purple&label=Good%20first%20issues&query=is%3Aopen%20label%3A%22good%20first%20issue%22)](https://github.com/lincc-frameworks/tape/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
 
-```
-$ conda create -n seriesenv python=3.11
-$ conda activate seriesenv
-
-$ git clone https://github.com/lincc-frameworks/tape
-$ cd tape/
-$ pip install .
-$ pip install .[dev]  # it may be necessary to use `pip install .'[dev]'` (with single quotes) depending on your machine.
-
-$ pip install pytest
-$ pytest
-```
+See the [Contribution Guide](https://tape.readthedocs.io/en/latest/gettingstarted/contributing.html) for complete installation instructions and contribution best practices.
 
 ## Acknowledgements
 
diff --git a/docs/gettingstarted.rst b/docs/gettingstarted.rst
index 03d043f2..ac48f975 100644
--- a/docs/gettingstarted.rst
+++ b/docs/gettingstarted.rst
@@ -9,4 +9,5 @@ we encourage you to open an issue on the
     :maxdepth: 1
 
     Installing TAPE <gettingstarted/installation>
-    Quickstart Guide <gettingstarted/quickstart>
\ No newline at end of file
+    Quickstart Guide <gettingstarted/quickstart>
+    Contribution Guide <gettingstarted/contributing>
\ No newline at end of file
diff --git a/docs/gettingstarted/contributing.rst b/docs/gettingstarted/contributing.rst
new file mode 100644
index 00000000..2c509f8f
--- /dev/null
+++ b/docs/gettingstarted/contributing.rst
@@ -0,0 +1,20 @@
+Contribution Guide
+==================
+
+Dev Guide - Getting Started
+---------------------------
+
+Download code and install dependencies in a conda environment. Run unit tests at the end as a verification that the packages are properly installed.
+
+.. code-block:: bash
+
+    conda create -n seriesenv python=3.11
+    conda activate seriesenv
+
+    git clone https://github.com/lincc-frameworks/tape
+    cd tape/
+    pip install .
+    pip install .[dev]  # it may be necessary to use `pip install .'[dev]'` (with single quotes) depending on your machine.
+
+    pip install pytest
+    pytest
diff --git a/docs/index.rst b/docs/index.rst
index a791d252..a1ff8fe2 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -29,6 +29,7 @@ The `Tutorials <https://tape.readthedocs.io/en/latest/tutorials.html>`_ section
 API-level information about TAPE is viewable in the 
 `API Reference <https://tape.readthedocs.io/en/latest/autoapi/index.html>`_ section.
 
+Learn more about contributing to this repository in our :doc:`Contribution Guide <gettingstarted/contributing>`.
 
 
 .. toctree::