From 37b6b8d37f38cbf563d8a14a0d92708eb3de4680 Mon Sep 17 00:00:00 2001 From: Julius Werner Date: Thu, 18 Apr 2019 16:47:46 -0700 Subject: [PATCH] docs: Update contribution guidelines for binary components This patch updates the contribution guidelines to refer to the new binary repository. Change-Id: I898dc58973be91c3f87be53a755269fca2e93174 Signed-off-by: Julius Werner --- contributing.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/contributing.rst b/contributing.rst index 6c94d9ce..bd950e51 100644 --- a/contributing.rst +++ b/contributing.rst @@ -107,6 +107,23 @@ Submitting Changes `Maintainers`_ will ask you to create a new patch set to resolve the problem. +Binary Components +----------------- + +- Platforms may depend on binary components submitted to the `Trusted Firmware + binary repository`_ if they require code that the contributor is unable or + unwilling to open-source. This should be used as a rare exception. +- All binary components must follow the contribution guidelines (in particular + licensing rules) outlined in the `readme.rst `_ file of + the binary repository. +- Binary components must be restricted to only the specific functionality that + cannot be open-sourced and must be linked into a larger open-source platform + port. The majority of the platform port must still be implemented in open + source. Platform ports that are merely a thin wrapper around a binary + component that contains all the actual code will not be accepted. +- Only platform port code (i.e. in the ``plat/`` directory) may rely on + binary components. Generic code must always be fully open-source. + -------------- *Copyright (c) 2013-2019, Arm Limited and Contributors. All rights reserved.* @@ -128,3 +145,5 @@ Submitting Changes .. _Gerrit Signed-off-by Lines guidelines: https://review.trustedfirmware.org/Documentation/user-signedoffby.html .. _Gerrit Change-Ids documentation: https://review.trustedfirmware.org/Documentation/user-changeid.html .. _TF-A Tests: https://git.trustedfirmware.org/TF-A/tf-a-tests.git/about/ +.. _Trusted Firmware binary repository: https://review.trustedfirmware.org/admin/repos/tf-binaries +.. _tf-binaries-readme: https://git.trustedfirmware.org/tf-binaries.git/tree/readme.rst -- 2.30.2