[IMP] contributing/documentation: rewrite the contribution guide

This commit restructures the contributing/documentation page to re-use
content introduced with the contributing/development page and to
display the two ways to contribute (github vs git) in content tabs
rather than sections.

The guide is simplified and updated to delegate long explanations to
other pages or websites, remove useless images and focus on getting
users ready to contribute.

task-2897123

Part-of: odoo/documentation#3265
This commit is contained in:
Antoine Vandevenne (anv)
2022-12-28 17:12:08 +00:00
parent f778ba89af
commit 872bee0033
13 changed files with 194 additions and 326 deletions
@@ -0,0 +1 @@
Once your changes are approved, the reviewer merges them and they appear online the next day!
Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.6 KiB

@@ -182,7 +182,8 @@ content. However, avoid adding too many images: it isn't necessary to illustrate
features, and it may overload your page.
.. important::
Don't forget to :ref:`compress your PNG files with pngquant <contributing/pngquant>`.
Don't forget to :ref:`compress your PNG files with pngquant
<contributing/documentation/first-contribution>`.
.. _contributing/screenshots:
Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.1 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.0 KiB

@@ -10,7 +10,7 @@ Use relative links for internal URLs
If you need to reference an internal documentation page or a file that is not sitting in the same
directory as your current page, always make use of *relative file paths* rather than *absolute file
paths*. An absolute file path indicates the location of the target from the root of its file tree. A
relative file path makes use of smart notations (such as ``../`` git that redirects to the parent
relative file path makes use of smart notations (such as ``../`` that redirects to the parent
folder) to indicate the location of the target *relative* to that of the source document.
Example
Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB