diff --git a/README.md b/README.md
index 5255e97..f45b499 100644
--- a/README.md
+++ b/README.md
@@ -45,16 +45,13 @@ Code style used by AlpineLab in all our projects.
 
 ## Best practices
 
-Some conventions are adopted and enforced, in no particular order:
+Some conventions are adopted and enforced, but cannot be translated as Rubocop
+rules (or are not supposed to). You will find those conventions as Markdown
+files in the [`docs`](docs) directory of this project, organized by subject:
 
-1. Developer-specific configuration files must be git-ignored globally, _e.g._:
-
-    * `.ruby-{version,gemset}`
-    * `docker-compose.override.yml`
-
-2. Project-specific configuration files must be git-ignored per project, _e.g._:
-
-    * `config/database.yml`
+* [File structure and organisation](docs/files.md)
+* [Rails-specific conventions](docs/rails.md)
+* [HTTP API development guidelines](docs/http-api.md)
 
 ## Releases
 
diff --git a/docs/files.md b/docs/files.md
new file mode 100644
index 0000000..4ce02d8
--- /dev/null
+++ b/docs/files.md
@@ -0,0 +1,10 @@
+# File structure and organization
+
+1. Developer-specific configuration files must be git-ignored globally, _e.g._:
+
+    * `.ruby-{version,gemset}`
+    * `docker-compose.override.yml`
+
+2. Project-specific configuration files must be git-ignored per project, _e.g._:
+
+    * `config/database.yml`