From 5dcf9f7e86a2e2f445a44d43ceec23742b8feeca Mon Sep 17 00:00:00 2001 From: "Antoine Vandevenne (anv)" Date: Tue, 6 Dec 2022 09:09:09 +0000 Subject: [PATCH] [IMP] contributing: list the ways to contribute to Odoo task-2897123 closes odoo/documentation#3151 X-original-commit: a309372d83dd6639700733b438f66430c5032ca8 Signed-off-by: Antoine Vandevenne (anv) Signed-off-by: Castillo Jonathan (jcs) --- content/contributing.rst | 69 ++++++++++++++++++++++++++++++++++++---- 1 file changed, 62 insertions(+), 7 deletions(-) diff --git a/content/contributing.rst b/content/contributing.rst index 157d5a698..f58a84e91 100644 --- a/content/contributing.rst +++ b/content/contributing.rst @@ -1,19 +1,74 @@ :show-content: -:show-toc: :hide-page-toc: ============ Contributing ============ -First, **thank you** for landing here and helping us improve Odoo! +First off, **thank you** for landing here and considering contributing to Odoo! -This documentation section is intended as a guide to making contributions for first-timers and -veterans. +This documentation serves as a guide for first-timer and veteran contributors. As an open-core +project, Odoo accepts contributions from everyone, Odoo employees and members of the Odoo community +alike. The Odoo community comprises users, developers, and other interested parties who contribute +their time and expertise. -As an open-core project, Odoo accepts contributions from everyone, Odoo employees and members of the -Odoo community alike, in all of its open-source `GitHub repositories -`_. +Depending on your skill set and interest, there are many ways to contribute to Odoo. The table below +lists the most important of them. + +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 20 35 25 20 + + * - Contribution + - Description + - Resources + - Target Audience + * - Join the community + - Participate in discussions on the forums, help answer questions, and assist other members of + the Odoo community. + - * `Odoo forums `_ + - Anyone interested in Odoo + * - Submit bug reports + - Help improve the stability of Odoo by reporting the bugs that you discover in :doc:`supported + versions ` directly to Odoo support. Make sure + to include as many details (version, environment, test scenario...) as possible. If you don't + have the Odoo Enterprise license required for contacting the support, open a new issue on the + GitHub repository of Odoo. + - * `Odoo support `_ + * `Issue tracker on GitHub `_ + - Users of Odoo + * - Translate Odoo + - Translate the user interface and documentation of Odoo into different languages. + - * `Odoo project on Transifex `_ + - Anyone fluent in multiple languages + * - Contribute to the codebase + - Submit pull requests to the Odoo GitHub repositories to fix bugs, add new features, or + improve the performance and reliability of the product. You can also review and comment on + pull requests from other contributors. By contributing to the codebase, you can make a direct + and lasting impact on the quality and features of Odoo. + - * :doc:`Guide: Contributing to the codebase ` + * :doc:`Developer tutorials ` + - Developers with experience in Python and web development + * - Contribute to the documentation + - Submit corrections and improvements to the Odoo documentation. The product evolves fast, and + it can be challenging to consistently reflect these changes in the documentation. By updating + the documentation, you can help many users find their way in Odoo. + - * :doc:`Guide: Contributing to the documentation ` + - Anyone interested in improving the Odoo documentation + * - Create custom modules + - Develop new modules to extend the functionality of Odoo. Custom modules can be made available + for free or paid on the Odoo App Store or on any other Odoo modules library. By creating + custom modules and making them available to others, you can help grow the Odoo ecosystem and + provide additional value to users of the platform. + - * `Odoo Apps Store `_ + - Developers with experience in Python and web development + +.. important:: + It is mainly Odoo employees who develop new features for the codebase and write new content for + the documentation. Be sure to discuss any idea for a new feature or page with the Odoo team so + they can give you the green light before you begin working on it. Some features may already be in + development on their side, and only approved features can be merged. .. toctree:: :titlesonly: