Hi TSC,

 As discussed in the last TSC meeting, we would like to add Cypress devs as platform maintainers for PSoC6 code in TF-M. Given that (afaik) we are the first non-ARM maintainer, I'd like to formalize the proposal. 

---

 Proposal to enhance maintainership of trusted-firmware-m repository to allow additional approvers

 Step 1: Add a MAINTAINERS file to the root of the tf-m repository. This file will follow the same format as the linux kernel MAINTAINERS file, but will only support a subset of options. Exact subset TBD but likely 'M', 'L', 'S', 'F' options will be supported. This MAINTAINERS file will initially be populated with the current designated +2 devs as having maintainer status over the complete tree. It is assume that current devs are already being notified of gerrit reviews so they don't need that step.

 Step 2: All tsc representatives will be granted +2/merge permissions into trusted-firmware-m. Allowable uses of this +2 are as follows:

 a) For gerrit reviews that exclusively involve changes to files+directories where the tsc rep's company is listed as maintainer in the MAINTAINERS file

 b) For gerrit reviews that involve changes to files+directories where the tsc rep's company is listed as maintainer in the MAINTAINERS file + other changes: only once other maintainers have +1 their portions (i.e. once all maintainers have +1, any of the companies involved in the patch can +2/merge it).

 Abuse of this privilege will be escalated to board for resolution.

 Step 3: on any patch that requires a change to maintainers (i.e. a new platform being added):

 a) the patch will include an update to the MAINTAINERS file indicating it. 

 b) the maintainers will add themselves to get notifications from gerrit for appropriate subtrees.

Responsibility of maintainers:

 - Ensure MAINTAINERS file and your gerrit notifications are kept up-to-date

 - Provide review in a timely fashion for any reviews that involve your subtree (preferably within a week)

 - Notify your tsc rep once a review has sufficient approvals to be +2ed.

Let me know of any comments, concerns, issues. If there is agreement on the above, I'll outline the steps with more detail + examples (in phabricator possibly or as a documentation patch to the code itself). 

 

 Thanks,

   Christian.