docs/process/platform-ports-policy.rst

10 Platform compatibility is mainly affected by changes to Platform APIs (as
12 library interfaces (like xlat_table library). The project will try to maintain
15 Due to evolving requirements and enhancements, there might be changes affecting
16 platform compatibility, which means the previous interface needs to be deprecated
17 and a new interface introduced to replace it. In case the migration to the new
18 interface is trivial, the contributor of the change is expected to make good
19 effort to migrate the upstream platforms to the new interface.
23 to upstream their platform code or copy the latest version of the code being
28 deprecated, the page must be updated to indicate the release after which the
30 For non-trivial interface changes, an email should be sent out to the `TF-A
31 public mailing list`_ to notify platforms that they should migrate away from the
32 deprecated interfaces. Platforms are expected to migrate before the removal of
39 to deprecate it to keep the projects' source tree clean and healthy. Deprecation
40 can be a 1-stage or 2-stage process (up to the maintainers).
50 platform ports (or soon to be) to this day.