1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
.. _contributing:
Contributing
************
We could use your help. If you are interesting in contributing then please
check out our `issue tracker <https://github.com/translate/translate/issues>`_ or
`discussions <https://github.com/translate/translate/discussions>`_.
Here are some idea of how you can contribute
- :ref:`Test <contributing#testing>` -- help us test new candidate releases
before they are released
- :ref:`Debug <contributing#debugging>` -- check bug reports, create tests to
highlight problems
- :ref:`Develop <contributing#developing>` -- add your Python developer skills
to the mix
- :ref:`Document <contributing#documenting>` -- help make our docs readable,
useful and complete
Below we give you more detail on these:
.. _contributing#testing:
Testing
=======
Before we release new versions of the Toolkit we need people to check that they
still work correctly. If you are a frequent user you might want to start using
the release candidate on your current work and report any errors before we
release them.
:doc:`Run unit tests </developers/testing>` to see if
there are any issues. Please report any failures.
Finally, simply work with the software. Checking all your current usage
patterns and report problems.
.. _contributing#debugging:
Debugging
=========
- Make sure your familiar with the :doc:`bug reporting guidelines
</developers/reporting_bugs>`.
- Create a login for yourself at https://github.com
- Then choose an `issue <https://github.com/translate/translate/issues>`_
Now you need to try and validate the bug. Your aim is to confirm that the bug
is either fixed, is invalid or still exists.
If its fixed please close the bug and give details of how when it was fixed or
what version you used to validate it as corrected.
If you find that the bug reporter has made the incorrect assumptions or their
suggestion cannot work. Then mark the bug as invalid and give reasons why.
The last case, an existing bug is the most interesting. Check through the bug
and do the following:
- Fix up the summary to make it clear what the bug is
- Create new bugs for separate issues
- Set severity level and classifications correctly
- Add examples to reproduce the bug, or make the supplied files simpler
- If you can identify the bug but not fix it then explain what needs fixing
- Move on to the next bug
.. _contributing#developing:
Developing
==========
Don't ignore this area if you feel like you are not a hotshot coder!
You will need some Python skills, this is a great way to learn.
**Quick Start:**
1. Install dependencies:
* Git
* Python 3.10 or newer
* `uv <https://docs.astral.sh/uv/>`_ (recommended package manager)
2. Clone and setup:
.. code-block:: sh
git clone https://github.com/translate/translate.git
cd translate
uv sync --all-extras --dev
This will create a virtual environment in ``.venv`` and install all
dependencies including development tools.
3. Run the tests:
.. code-block:: sh
make test
**What you can contribute:**
* Write a test to expose some bug
* Try to fix the actual code to fix your bug
* Add a small piece of functionality that helps you
* Document the methods in especially the base class and derived classes
* Add a :doc:`format </formats/index>` type and converters
* Add more features to help our formats :doc:`conform to the standards
</formats/conformance>`
Now is the time to familiarise yourself with the :doc:`developers guide
<developers>`.
.. _contributing#documenting:
Documenting
===========
This is the easy one. Login to the wiki and start!
The key areas that need to be looked at are:
- Do the guides to each tool cover all command line options
- Are the examples clear for the general cases
- Is the tools use clear
- In the Use cases, can we add more, do they need updating. Has upstream
changed its approach
After that and always:
* Grammar
* Spelling
* Layout
|
