diff --git a/doc/04-schema.md b/doc/04-schema.md
index ad8be8971..480ee742f 100644
--- a/doc/04-schema.md
+++ b/doc/04-schema.md
@@ -29,13 +29,16 @@ The config of dependencies is ignored. This makes the `config` field
 ### name
 
 The name of the package. It consists of vendor name and project name,
-separated by `/`.
-
-Examples:
+separated by `/`. Examples:
 
 * monolog/monolog
 * igorw/event-source
 
+The name can contain any character, including white spaces, and it's case
+sensitive (`foor/bar` is considered a different package than `Foo/Bar`). In order
+to simplify its installation, it's recommended to define a short and lowercase
+name that doesn't include non-alphanumeric characters or white spaces.
+
 Required for published packages (libraries).
 
 ### description