diff --git a/docs/about/contact.rst b/docs/about/contact.rst index 9cb25ef47..7c6a5de78 100644 --- a/docs/about/contact.rst +++ b/docs/about/contact.rst @@ -27,9 +27,9 @@ You can see a `summary of all the lists`_ on the TrustedFirmware.org website. Issue Tracker ^^^^^^^^^^^^^ -Specific issues may be raised using the `issue tracker`_ on the -TrustedFirmware.org website. Using this tracker makes it easy for the -maintainers to prioritise and respond to your ticket. +Bug reports may be filed on the `issue tracker`_ on the TrustedFirmware.org +website. Using this tracker gives everyone visibility of the known issues in +TF-A. Arm Licensees ^^^^^^^^^^^^^ @@ -44,4 +44,4 @@ via their partner managers. -------------- -*Copyright (c) 2019, Arm Limited. All rights reserved.* +*Copyright (c) 2019-2020, Arm Limited. All rights reserved.* diff --git a/docs/process/contributing.rst b/docs/process/contributing.rst index 7886cf4f5..5e490a967 100644 --- a/docs/process/contributing.rst +++ b/docs/process/contributing.rst @@ -6,12 +6,16 @@ Getting Started - Make sure you have a Github account and you are logged on both `developer.trustedfirmware.org`_ and `review.trustedfirmware.org`_. -- Create an `issue`_ for your work if one does not already exist. This gives - everyone visibility of whether others are working on something similar. - - If you intend to include Third Party IP in your contribution, please - raise a separate `issue`_ for this and ensure that the changes that - include Third Party IP are made on a separate topic branch. +- If you plan to contribute a major piece of work, it is usually a good idea to + start a discussion around it on the mailing list. This gives everyone + visibility of what is coming up, you might learn that somebody else is + already working on something similar or the community might be able to + provide some early input to help shaping the design of the feature. + + If you intend to include Third Party IP in your contribution, please mention + it explicitly in the email thread and ensure that the changes that include + Third Party IP are made in a separate patch (or patch series). - Clone `Trusted Firmware-A`_ on your own machine as described in :ref:`prerequisites_get_source`. @@ -29,8 +33,7 @@ Making Changes Makefile target is provided for convenience. - Keep the commits on topic. If you need to fix another bug or make another - enhancement, please create a separate `issue`_ and address it on a separate - topic branch. + enhancement, please address it on a separate topic branch. - Avoid long commit series. If you do have a long series, consider whether some commits should be squashed together or addressed in a separate topic. - Make sure your commit messages are in the proper format. If a commit fixes diff --git a/docs/process/security.rst b/docs/process/security.rst index 516eb98d7..0d59e723c 100644 --- a/docs/process/security.rst +++ b/docs/process/security.rst @@ -21,12 +21,12 @@ Although we try to keep TF-A secure, we can only do so with the help of the community of developers and security researchers. If you think you have found a security vulnerability, please **do not** report -it in the `issue tracker`_. Instead, please follow the `TrustedFirmware.org -security incident process`_. One of the goals of this process is to ensure -providers of products that use TF-A have a chance to consider the implications -of the vulnerability and its remedy before it is made public. As such, please -follow the disclosure plan outlined in the process. We do our best to respond -and fix any issues quickly. +it in the `issue tracker`_ or on the `mailing list`_. Instead, please follow the +`TrustedFirmware.org security incident process`_. One of the goals of this +process is to ensure providers of products that use TF-A have a chance to +consider the implications of the vulnerability and its remedy before it is made +public. As such, please follow the disclosure plan outlined in the process. We +do our best to respond and fix any issues quickly. Afterwards, we encourage you to write-up your findings about the TF-A source code. @@ -69,6 +69,7 @@ Security Advisories +-----------+------------------------------------------------------------------+ .. _issue tracker: https://developer.trustedfirmware.org/project/board/1/ +.. _mailing list: https://lists.trustedfirmware.org/mailman/listinfo/tf-a .. |TFV-1| replace:: :ref:`Advisory TFV-1 (CVE-2016-10319)` .. |TFV-2| replace:: :ref:`Advisory TFV-2 (CVE-2017-7564)`