# Readme and contributing info

- Thread: https://externals.io/message/100894
- Original archive: https://news-web.php.net/php.internals/100894
- Started by Peter Kokot on 2017-10-13T19:28:51+00:00
- Messages: 1
- Reply by email to internals@lists.php.net
- More for agents: search with https://externals.io/search.md?q={query} · JSON API at https://externals.io/api · documentation at https://externals.io/llms.txt

---

## #100894 — Peter Kokot — 2017-10-13T19:28:51+00:00

URL: https://externals.io/message/100894#100894

Hello, in the php-src repository there are few files mentioning the
contributing procedure. If I may suggest few improvements and
readability cosmetics:
https://github.com/php/php-src/pull/2833

What has been changed so far?
- PHP installation procedure would be best described at a single entry
php.net/install
- The README.md includes a brief PHP general description, Git
repositories links, PHP installation info, and a link to a
CONTRIBUTING.md file
- README.GIT-RULES and README.SUBMITTING_PATCH files are joined into
an existing CONTRIBUTING.md file
- README.WIN32-BUILD-SYSTEM is redundant and removed in favor of the README.md
- INSTALL file removed in favor of the main README.md file
- windows archive package gets readme.txt attached from README.md

In the current PHP-7.x branches there was a practice to generate an
installation information from the documentation repository and
attached as INSTALL and win32/install.txt files which isn't so anymore
with master branch on I believe.

Reason for all these refactorings is simplicity for people not used to
contributing to php-src repo yet still having all the relevant
information in the repo.

If possible, can someone please take a look at these or suggest
something better? I plan to do some more cosmetic improvements later on also.

Thanks.

-- 
Peter Kokot