diff --git a/README.md b/README.md
index 45706d24256..09dde4fdb86 100644
--- a/README.md
+++ b/README.md
@@ -94,8 +94,8 @@ contribute:
 
 - [Contributing to PHP](/CONTRIBUTING.md)
 - [PHP coding standards](/CODING_STANDARDS)
-- [Mailinglist rules](/README.MAILINGLIST_RULES)
-- [PHP release process](/README.RELEASE_PROCESS)
+- [Mailinglist rules](/docs/mailinglist-rules.md)
+- [PHP release process](/docs/release-process.md)
 
 ## Testing
 
diff --git a/README.input_filter b/docs/input-filter.md
similarity index 100%
rename from README.input_filter
rename to docs/input-filter.md
diff --git a/README.MAILINGLIST_RULES b/docs/mailinglist-rules.md
similarity index 100%
rename from README.MAILINGLIST_RULES
rename to docs/mailinglist-rules.md
diff --git a/README.NEW-OUTPUT-API b/docs/output-api.md
similarity index 100%
rename from README.NEW-OUTPUT-API
rename to docs/output-api.md
diff --git a/README.PARAMETER_PARSING_API b/docs/parameter-parsing-api.md
similarity index 100%
rename from README.PARAMETER_PARSING_API
rename to docs/parameter-parsing-api.md
diff --git a/README.RELEASE_PROCESS b/docs/release-process.md
similarity index 100%
rename from README.RELEASE_PROCESS
rename to docs/release-process.md
diff --git a/README.SELF-CONTAINED-EXTENSIONS b/docs/self-contained-extensions.md
similarity index 100%
rename from README.SELF-CONTAINED-EXTENSIONS
rename to docs/self-contained-extensions.md
diff --git a/README.STREAMS b/docs/streams.md
similarity index 100%
rename from README.STREAMS
rename to docs/streams.md
diff --git a/README.UNIX-BUILD-SYSTEM b/docs/unix-build-system.md
similarity index 100%
rename from README.UNIX-BUILD-SYSTEM
rename to docs/unix-build-system.md