blob: 761f52fb1a11373946e8ba85e2f6d601061995c3 (
plain)
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
|
Contributing
============
Contributions to the TF-M project need to follow the process below.
.. Note::
Please contact :doc:`maintainers </docs/contributing/maintainers>` for any
questions.
- Subscribe to `TF-M development
<https://lists.trustedfirmware.org/mailman/listinfo/tf-m>`_ if not subscribed
already.
- Refer to the `Roadmap
<https://developer.trustedfirmware.org/w/tf_m/planning>`_ or send a mail to
the tf-m@lists.trustedfirmware.org to check if this work is already
planned/progresses elsewhere.
- Create a task in `Phabricator
<https://developer.trustedfirmware.org/maniphest>`_, put as many details as
possible in the description. Add 'Trusted Firmware M' in the 'Tags' field.
- For non-trivial changes, need to follow the design proposal process
:doc:`Design Proposal Process </docs/contributing/tfm_design_proposal_process>`
for the TF-M project.
- After the design has been accepted by the maintainer(s), a corresponding
patch should be posted; follow guidelines below:
- Clone the TF-M code on your own machine from `TF-M git repository
<https://git.trustedfirmware.org/TF-M/trusted-firmware-m.git>`_.
- Follow the :doc:`SW Requirements </docs/getting_started/tfm_sw_requirement>`,
:doc:`Build Instructions </docs/getting_started/tfm_build_instruction>` and
:doc:`Coding Guide </docs/contributing/coding_guide>` for the TF-M project.
- Make your changes in logical chunks to help reviewers. Each commit should
be a separate review and either work properly or be squashed after the
review and before merging.
- Update documentation in docs/ folder if needed.
- Test your changes and add details to the commit description.
- The code is accepted under :doc:`DCO </docs/contributing/dco>`, Developer
Certificate of Origin, so you must add following fields to your
commit description:
.. code-block:: text
Author: Full Name <email address>
Signed-off-by: Full Name <email address>
.. Note::
Sign off authority needs to adhere to the [DCO](./dco.txt) rules.
- You may add other fields in the commit message. Need to add the Task ID link
in the comment for the commit.
- Submit your patch for review.
.. code-block:: shell
git push ssh://review.trustedfirmware.org:29418/TF-M/trusted-firmware-m.git HEAD:refs/for/master
- Add relevant :doc:`maintainers </docs/contributing/maintainers>` for reviewing
the patch.
- You may be asked to provide further details or make additional changes.
- You can discuss further with maintainer(s) by directly over email if
necessary.
- Once the change is approved by maintainers, the patch will be merged by the
maintainer.
- Mark the task as 'resolved' after patch is merged.
--------------
*Copyright (c) 2017-2020, Arm Limited. All rights reserved.*
|