diff --git a/docs/standard/example/publiccode.minimal.yml b/docs/standard/example/publiccode.minimal.yml
index 10a2504..d939557 100644
--- a/docs/standard/example/publiccode.minimal.yml
+++ b/docs/standard/example/publiccode.minimal.yml
@@ -34,6 +34,5 @@ maintenance:
     - name: Francesco Rossi
 
 localisation:
-  localisationReady: true
   availableLanguages:
     - en
diff --git a/docs/standard/example/publiccode.yml b/docs/standard/example/publiccode.yml
index bf92764..3a6d83d 100644
--- a/docs/standard/example/publiccode.yml
+++ b/docs/standard/example/publiccode.yml
@@ -87,7 +87,6 @@ maintenance:
       phone: "+3923113215112"
 
 localisation:
-  localisationReady: true
   availableLanguages:
     - en
     - it
diff --git a/docs/standard/schema.core.rst b/docs/standard/schema.core.rst
index 565a3c8..f6df3e5 100644
--- a/docs/standard/schema.core.rst
+++ b/docs/standard/schema.core.rst
@@ -723,16 +723,19 @@ Section ``localisation``
 This section provides an overview of the localization features of the
 software.
 
-Key ``localisation/localisationReady``
-''''''''''''''''''''''''''''''''''''''
+Key ``localisation/localisationReady`` (*deprecated*)
+'''''''''''''''''''''''''''''''''''''''''''''''''''''
 
 -  Type: boolean
--  Presence: mandatory
+-  Presence: optional
 
 If ``true``, the software has infrastructure in place or is otherwise
 designed to be multilingual. It does not need to be available in more
 than one language.
 
+This key is deprecated, use ``localisation/availableLanguages`` to
+state the languages the software is available in.
+
 Key ``localisation/availableLanguages``
 '''''''''''''''''''''''''''''''''''''''