diff --git a/doc/04-schema.md b/doc/04-schema.md
index ad8be8971..415acb837 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
+insensitive (`foo/bar` and `Foo/Bar` are considered the same package). 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