Merge branch 'master' into api_part_2

.readthedocs.yaml

@@ -1,14 +1,29 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
 version: 2
 
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  jobs:
+    pre_build:
+      # Generate the Sphinx configuration for this Jupyter Book so it builds.
+      - "jupyter-book config sphinx docs"
+
+# Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/conf.py
   fail_on_warning: false
 
-build:
-  os: ubuntu-22.04
-  tools:
-    python: "3.10"
+# Optionally build your docs in additional formats such as PDF and ePub
+formats: []
 
+# Optionally set the version of Python and requirements required to build your docs
 python:
   install:
     - requirements: docs/requirements.txt

CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+## Version 0.4.0
+* PR [#82](https://github.com/SnowEx/snowexsql/pull/82)

CONTRIBUTING.rst

@@ -0,0 +1,70 @@
+***********************
+Contributing Guidelines
+***********************
+
+.. |Contributor Covenant| image:: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg
+  :target: https://github.com/SnowEx/snowexsql/blob/master/CODE_OF_CONDUCT.md
+
+Thank you for your interest in contributing to snowexsql! We welcome
+contributions of any size from anyone regardless of career stage and level of
+coding experience.
+
+Here we provide a set of guidelines and information for contributing to
+snowexsql. This project is released with a Contributor Code of Conduct. By
+participating in this project you agree to abide by its terms.
+
+|Contributor Covenant|
+
+Ways to Contribute
+==================
+
+Report a Bug
+------------
+
+Find the *Issues* tab at the top of GitHub repository and click the *New Issue* button. Give your issue a clear title and describe the steps required to recreate it in as much detail as possible. If you can, include a small example that reproduces the error. More information and minimal examples will help us resolve issues faster.
+
+Asking a Question
+-----------------
+
+Please do not create issues to ask for help. A faster way to reach the community is through our `snowex-sql Discussions page <https://github.com/SnowEx/snowexsql/discussions>`_. We are excited to have you join an existing conversation or start a new post! 
+
+Write Documentation
+-------------------
+
+Found a typo in the documentation or have a suggestion to make it clearer? Consider letting us know by creating an issue or (better yet!) submitting a fix. This is a great, low stakes way to practice the pull request process!
+
+Discovered a currently untested case? Please share your test, either by creating an issue or submitting a pull request to add it to our suite of test cases.
+
+Add an Example
+^^^^^^^^^^^^^^
+
+Examples are a great way to show how to use snowexsql. If you have a use case that you think would be helpful to others, please consider adding it to the `examples directory <https://snowexsql.readthedocs.io/en/latest/examples.html>`_.
+
+Request a Feature
+-----------------
+
+The best way to request a feature is to file an issue at `https://github.com/SnowEx/snowexsql/issues <https://github.com/SnowEx/snowexsql/issues>`_.
+
+When requesting a feature, please:
+
+- Explain in detail how it would work.
+- Keep the scope as narrow as possible, to make it easier to implement.
+- Let us know if this is something you would like to work on!
+
+Contribute Code
+---------------
+
+.. _how to contribute: https://snowexsql.readthedocs.io/en/latest/community/how_to_contribute.html
+
+Please see our `how to contribute`_ guide on getting started to add your code
+and ideas.
+
+Licensing
+^^^^^^^^^
+SnowExSQL is licensed under the `BSD-3 license <https://opensource.org/licenses/BSD-3-Clause>`_. Contributed code will also be licensed under BSD-3. If you did not write the code yourself, it is your responsibility to ensure that the existing license is compatible and included in the contributed files or you have documented permission from the original author to relicense the code.
+
+Attribution
+===========
+.. _list of current contributors: https://snowexsql.readthedocs.io/en/latest/community/authors.html
+
+See our `list of current contributors`_ that have helped shape this project.