Skip to content

Security Team members listing in PMI is confusing

The readability of the Security Team section could be improved. Currently, individual members are listed under a heading styled the same way as the Security Team section or the Historical Committers section:

image

There is no visual clue to help understand that list of individual users are about the security team. It reads like:

## Security Team
All Project-Leads are members of this project's security team.

## Individual Users
* User A
* User B

## Historical Committers

I would expect the list of individual members to appear under a subheading, for example:

## Security Team
All Project-Leads are members of this project's security team.

### Individual Users
* User A
* User B

## Historical Committers

Alternatively, we could remove the “Individual Users” title altogether and instead conditionally add a second sentence to the Security Team description, for example:

## Security Team
All Project-Leads are members of this project's security team. Additionally, the individual users listed below are also members of this project's security team:
* User A
* User B

## Historical Committers

WDYT?