rfc:policy-repository

This is an old revision of the document!


PHP RFC: Your Title Here

Introduction

Currently, policies in regard to RFC Voting, the Release Process, security classification, and naming guidelines are all recorded in different places. In RFCs, through amending RFCs (think “Abolish Short Votes”), etc. This makes it sometimes hard to find out what is expected, and how things are supposed to be.

Proposal

This proposal suggests to set up a new Git repository to collect all the policies that we have. RFCs to add or amend to policy would then target additions or modification of the documents in this repository, instead of having them just as RFC text.

Similarly, the canonical security classification will move from https://github.com/php/php-src/blob/master/SECURITY.md to https://github.com/php/policies/blob/main/security-classification.rst, with the former explaining how to file security issues only instead.

Proposed PHP Version(s)

As this is not for a specific PHP version, it is not targeting one either.

Open Issues

- Should the historical information be moved out of release-process to a dedicated file?

Proposed Voting Choices

Do we want all the policies in one place in a Git repository? 2/3rds majority required.

Patches and Tests

A preliminary repository has been set up at https://github.com/php/policies

It currently contains information from the following documents:

Releases and Security

- Release Process: https://wiki.php.net/rfc/releaseprocess - Security Issue Classification: https://wiki.php.net/rfc/security-classification

RFC Votes

- Voting on PHP features: https://wiki.php.net/rfc/voting - Abolish Short Votes: https://wiki.php.net/rfc/abolish-short-votes - Abolish Narrow Margins: https://wiki.php.net/rfc/abolish-narrow-margins

Support Timelines

- PHP 5 Support Timeline: https://wiki.php.net/rfc/php56timeline - Define PHP 5.3 End of Life: https://wiki.php.net/rfc/php53eol - Name of Next Release of PHP: https://wiki.php.net/rfc/php6 - PHP 7.0 timeline: https://wiki.php.net/rfc/php7timeline - Cleaning Up Unmaintained Extensions: https://wiki.php.net/rfc/umaintained_extensions

Naming Things

- Namespaces in bundled PHP extensions: https://wiki.php.net/rfc/namespaces_in_bundled_extensions - Class Naming: https://wiki.php.net/rfc/class-naming

References

Links to external references, discussions or RFCs

rfc/policy-repository.1701710605.txt.gz · Last modified: 2023/12/04 17:23 by derick