mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-16 09:34:18 +00:00

With the transition to mailman3, the URLs of TF-A and TF-A Tests mailing lists have changed. However, we still refer to the old location, which are now dead links. Update all relevant links throughout the documentation. There is one link referring to a specific thread on the TF-A mailing list in the SPM documentation, for which I had to make a guess as to what's the equivalent mailman3 URL. The old URL scheme indicates that the thread dates from February 2020 but beyond that, I could not make sense of the thread id within the old URL so I picked the most likely match amongst the 3 emails posted on the subject in this time period. Signed-off-by: Sandrine Bailleux <sandrine.bailleux@arm.com> Reported-by: Kuohong Wang <kuohong.wang@mediatek.com> Change-Id: I83f4843afd1dd46f885df225931d8458152dbb58
36 lines
1.6 KiB
ReStructuredText
36 lines
1.6 KiB
ReStructuredText
Platform Compatibility Policy
|
|
=============================
|
|
|
|
Introduction
|
|
------------
|
|
|
|
This document clarifies the project's policy around compatibility for upstream
|
|
platforms.
|
|
|
|
Platform compatibility policy
|
|
-----------------------------
|
|
|
|
Platform compatibility is mainly affected by changes to Platform APIs (as
|
|
documented in the :ref:`Porting Guide`), driver APIs (like the GICv3 drivers) or
|
|
library interfaces (like xlat_table library). The project will try to maintain
|
|
compatibility for upstream platforms. Due to evolving requirements and
|
|
enhancements, there might be changes affecting platform compatibility which
|
|
means the previous interface needs to be deprecated and a new interface
|
|
introduced to replace it. In case the migration to the new interface is trivial,
|
|
the contributor of the change is expected to make good effort to migrate the
|
|
upstream platforms to the new interface.
|
|
|
|
The deprecated interfaces are listed inside :ref:`Release Processes` as well as
|
|
the release after which each one will be removed. When an interface is
|
|
deprecated, the page must be updated to indicate the release after which the
|
|
interface will be removed. This must be at least 1 full release cycle in future.
|
|
For non-trivial interface changes, an email should be sent out to the `TF-A
|
|
public mailing list`_ to notify platforms that they should migrate away from the
|
|
deprecated interfaces. Platforms are expected to migrate before the removal of
|
|
the deprecated interface.
|
|
|
|
--------------
|
|
|
|
*Copyright (c) 2018-2022, Arm Limited and Contributors. All rights reserved.*
|
|
|
|
.. _TF-A public mailing list: https://lists.trustedfirmware.org/mailman3/lists/tf-a.lists.trustedfirmware.org/
|