add a contributing section to the docs

This section outlines how one can contribute to the MITgcm project, provides instructions, and describes the code style used in this project.

Author: edoddridge

doc/contributing.rst

@@ -0,0 +1,64 @@
+.. _chap_contributing:
+
+Contributing to the MITgcm
+**************************
+
+The MITgcm is an open source project that relies on the participation of its users, and we welcome  contributions. This chapter sets out how you can contribute to the MITgcm.
+
+
+Bugs and feature requests
+=========================
+
+If you think you've found a bug, the best thing to check that you're using the latest version of the model. If the bug is still in the latest version, then think about how you might fix it and file a ticket in the GitHub issue tracker [url to be inserted once we have the proper repo]. Please include as much detail as possible. At a minimum your ticket should include:
+
+ - what the bug does;
+ - the location of the bug: file name and line number(s); and
+ - any suggestions you have for how it might be fixed.
+
+To request a new feature, or guidance on how to implement it yourself, please open a ticket with the following details:
+
+ - a clear explanation of what the feature will do; and
+ - a summary of the equations to be solved.
+
+
+
+Contributing to the code
+========================
+
+To contribute to the source code of the model you will need to fork the repository and place a pull request on GitHub. The two following sections describe this process in different levels of detail. If you are unfamiliar with git, you may wish to skip the Quickstart guide and use the detailed instructions. All contributions are expected to conform with the :ref:`subsec_code_style_guide`.
+
+
+Quickstart Guide
+----------------
+
+
+
+Detailed guide
+--------------
+
+
+.. _subsec_code_style_guide:
+
+Style guide
+-----------
+
+
+
+Contributing to the manual
+==========================
+
+
+
+Quickstart Guide
+----------------
+
+
+
+Detailed guide
+--------------
+
+
+.. _subsec_manual_style_guide:
+
+Style guide
+----------------------

doc/index.rst

@@ -15,4 +15,5 @@ Welcome to MITgcm's user manual
    phys_pkgs/phys_pkgs
    getting_started/getting_started
    examples/examples
+   contributing
    zreferences