Add contributing guidelines

Author: IsabelParedes

docs/dev_contribute.rst

@@ -0,0 +1,123 @@
+Contributing Guidelines
+=======================
+
+First off, thank you for considering contributing to JupyterLab-URDF 🥳. It's 
+people like you that make JupyterLab-URDF such a great tool.
+
+Following these guidelines helps to communicate that you respect the time of the
+developers managing and developing this open source project. In return, they
+should reciprocate that respect in addressing your issue, assessing changes, and
+helping you finalize your pull requests.
+
+JupyterLab-URDF is an open source project and we love to receive contributions
+from our community — you! There are many ways to contribute. For example, you
+could
+
+* write a new tutorial or a blog post
+* improve the documentation or the existing examples
+* submit bug reports or feature requests
+* write code to incorporate into JupyterLab-URDF itself
+
+Ground Rules
+------------
+
+We welcome all kinds of contribution and value them highly. We pledge to treat
+everyone's contribution fairly and with respect, and we are here to bring
+awesome pull requests over the finish line.
+
+Please note that we adhere to the `Python Community Code of Conduct 
+<https://www.python.org/psf/conduct/>`_ and by contributing to this project
+you also agree to follow the same guidelines.
+
+Your First Contribution
+-----------------------
+
+Working on your first Pull Request? Here are some resources to help you get started:
+
+* `First Timers Only <https://www.firsttimersonly.com/>`_
+* `Make a Pull Request <https://makeapullrequest.com/>`_
+* `How to Contribute to an Open Source Project on GitHub <https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github>`_
+
+At this point, you're ready to make your changes! Feel free to ask for help;
+everyone is a beginner at first 😸.
+
+If a maintainer asks you to "rebase" your PR, they're saying that a lot of code
+has changed and that you need to update your branch so that it's easier to
+merge.
+
+Getting Started
+---------------
+
+#. Create your own fork of the repository.
+#. Do the changes in your fork.
+#. If your changes only involve spelling or grammar fixes, move to step 6.
+#. Test your changes in a clean environment and update installation instructions and dependencies as needed.
+#. When adding new features, make sure to update the documentation and provide an example.
+#. If you are happy with your changes, create a pull request.
+
+How to Report a Bug
+-------------------
+
+**Security**
+
+If you find a security vulnerability, do NOT open an issue. Email 
+`isabel.paredes@quantstack.net <mailto:isabel.paredes@quantstack.net>`_ instead.
+In order to determine whether you are dealing with a security issue, ask
+yourself these two questions:
+
+* Can I access something that's not mine, or something I shouldn't have access to?
+* Can I disable something for other people?
+
+If the answer to either of those two questions is *YES*, then you're probably
+dealing with a security issue. Note that even if you answer *NO* to both
+questions, you may still be dealing with a security issue, so if you're unsure,
+just email us.
+
+**Other bugs**
+
+When filing an issue, make sure to answer these five questions:
+
+#. What version of ``jupyterlab-urdf`` are you using?
+#. What operating system and processor architecture are you using?
+#. What did you do?
+#. What did you expect to see?
+#. What did you see instead?
+
+General questions should be handled through the
+`QuantStack/Lobby <https://matrix.to/#/#QuantStack_Lobby:gitter.im>`_ instead of
+the issue tracker. The maintainers there will answer or ask you to file an issue
+if you've tripped over a bug.
+
+How to Suggest a Feature or Enhancement
+---------------------------------------
+
+If you find yourself wishing for a feature that doesn't exist in 
+JupyterLab-URDF, you are probably not alone. There are bound to be others out
+there with similar needs. Many of the features that JupyterLab-URDF has today
+have been added because our users saw the need. Open an issue on our [issues list](https://github.com/jupyter-robotics/JupyterLab-URDF/issues) on GitHub which includes the following:
+
+#. A description of the feature you would like to see
+#. Why do you need it?
+#. How should it work?
+
+Code Review Process
+-------------------
+
+Any change to resources in this repository must be through pull requests. This
+applies to all changes to documentation, code, binary files, etc. No pull
+request can be merged without being reviewed.
+
+The core team looks at Pull Requests on a regular basis and provides feedback
+after each review. Once feedback has been given, we expect responses within
+four weeks. After the four weeks have elapsed, we may close the pull request if
+it isn't showing any activity.
+
+A pull request will be merged once all the feedback has been addressed and there
+are no objections by any of the committers.
+
+Community
+---------
+
+You can chat with the core team on 
+`QuantStack/Lobby <https://matrix.to/#/#QuantStack_Lobby:gitter.im>`_. We try to
+answer all questions within 48 hours.