fig-standards README

The project's README from github.com/php-fig/fig-standards. As one markdown file: README.md.

PHP Framework Interoperability Group

The idea behind the group is for project representatives to talk about the commonalities between our projects and find ways we can work together. Our main audience is each other, but we’re very aware that the rest of the PHP community is watching. If other folks want to adopt what we’re doing they are welcome to do so, but that is not the aim.

Proposing a Standard Recommendation

To propose a PHP Standard Recommendation (PSR):

GitHub usage

All discussion regarding a PSR happens on the mailing list. Issues filed in GitHub are rarely monitored, and PRs are likely to be missed unless a message is sent to the mailing list regarding them. Reviews of a proposed PSR should be conducted on the mailing list, not through PR comments for the same reason.

Please do not simply file an issue or PR and walk-away. The most likely outcome is that it will never get seen or addressed.

Requesting Membership

You do not need to be a voting member to participate in discussion on the mailing list.

To become a voting member, you must send an email to the mailing list.

Do not combine separate membership requests in a single thread; one request per thread, please.

Language & Translations

All PSRs are written in British English or American English (Different specifications may vary, but it is consistent within the same specification). The PHP FIG does not offer official translations into other languages but other external entities are free to translate the specifications in accordance with the license.

Voting Members

The current list of voting members is available on the project website.

fig-standards (php-fig/fig-standards)

Searching Database…

12.5K ·GitHub
Fig-standards
Что это такое?Это репозиторий PHP-FIG с документами PSR (PHP Standard Recommendations), то есть спецификациями, которые предлагает и утверждает группа PHP Framework Interoperability Group. Их цель — стандартизировать типовые подходы во фреймворках и библиотеках PHP.
Это библиотека или просто документы?Это набор документов-спецификаций (сами PSR), а не код, который нужно устанавливать или запускать.
Как предложить новый стандарт?Сделайте форк репозитория, создайте ветку, добавьте свой PSR в каталог proposed/, отправьте ветку и создайте пулл-реквест. Также можно открыть тикет в GitHub или начать обсуждение в списке рассылки.
Нужно ли быть членом группы, чтобы обсуждать предложение?Нет, в обсуждении в списке рассылки может участвовать любой. А вот стать голосующим членом можно только через формальную заявку на членство.
Поможет ли пулл-реквест или тикет в GitHub добиться рассмотрения моего предложения?Нет. За тикетами и пулл-реквестами в GitHub почти не следят, поэтому всё реальное обсуждение и рассмотрение PSR должно проходить в списке рассылки.
Кому на самом деле адресована эта группа?Основная аудитория группы — представители других PHP-проектов, но широкое сообщество PHP тоже может следить за работой группы и применять стандарты.
Как стать голосующим членом PHP-FIG?Отправьте письмо в список рассылки с темой 'Membership Request: {yourname} ({projectname})', указав своё имя и ссылку на проект. Затем текущие участники проголосуют по вашей заявке.
На каком языке написаны PSR?Все PSR написаны на британском или американском английском (в рамках одной спецификации используется единый вариант). PHP-FIG не выпускает официальных переводов, но сторонние лица могут переводить их на условиях лицензии.
What are similar projects?toml, fantasy-land, agents.md, api-guidelines, swift-evolution, design, spec, rfcs
Which topics is it in?standards, specification, php, documentation, free, open-source
Creator
php-fig
Size
3.4 MB
Stars
12.5K
Updated
CommitJul 03
Age
15y
Commits · 90 Days