##################
Contribution guide
##################

.. contents::
   :depth: 2
   :local:

There are several ways to contribute to RPA framework.
The following sections describe the common ways you can help improve
the project.

Reporting bugs
==============

Bugs should be primarily reported through the GitHub `issue tracker`_.

When making a bug report, try to explain the bug clearly, what
the expected outcome was, and possibly the steps to reproduce it.

The report should contain at least the following information:

- rpaframework library version
- Python version
- Operating system
- Error message and traceback, if applicable

If possible, supply a minimal example that replicates the problem. This
will help in tracking down and fixing the issue.

.. _tracker:
.. _issue tracker: https://github.com/robocorp/rpaframework/issues

Requesting enhancements
=======================

If you think there is something missing from the project, it's possible to
request enhancements through the `issue tracker`_ as well. This can be anything
from new libraries to improvements in documentation.

A good enhancement proposal should describe the problem it is trying to
solve and - in case of a library - example ways how it would be used.

If you're unsure if the request is worth implementing, you can first ask
from the **#rpaframework** channel in `Robot Framework Slack`_.

.. _Slack:
.. _Robot Framework Slack: https://robotframework-slack-invite.herokuapp.com/

Submitting content
==================

Instead of creating a request for a new feature, it is also possible
to directly submit pull requests via GitHub. Direct contributions
from external developers are welcome to any part of the project,
be it a new library or a fix to a typo in this documentation.

However, before submitting a large pull request, it's advised to discuss it
beforehand on the Slack_ or in a corresponding issue on the tracker_.