From 2e81cb5cf717ef68df9bd66d2af1c7f5ccaaa3fe Mon Sep 17 00:00:00 2001
From: Jules Aguillon
Date: Sun, 29 May 2022 12:27:46 +0200
Subject: Automatically place localized keys on the layouts

Layouts no longer need to mention every localized keys and dead keys.
They are now placed automatically starting from the second row on the
bottom-right corner.

The "loc " prefix is not removed to still be able to define a more
optimal and consistent placement for some extra keys (eg. 'ß' near 's').

Programming layouts no longer need to place every dead keys.
---
 CONTRIBUTING.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

(limited to 'CONTRIBUTING.md')

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4a107b1..8a31530 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -83,17 +83,16 @@ make installd
 A programming layout must contains every ASCII characters.
 The current programming layouts are: QWERTY, Dvorak.
 
-Ideally, programming layouts should allow to type every Latin-script languages
-by containing every dead-keys. See for example: 0bf7ff5 (Latvian), 573c13f (Swedish).
-It is also possible to add some characters that are hidden in other languages,
-for example 93e84ba (ß), though the space is limited.
-
 Layouts are defined in XML, see `res/xml/qwerty.xml`. An entry must be added to
 the layout option in `res/values/arrays.xml`, to both `pref_layout_values`
 (correspond to the file name) and `pref_layout_entries` (display name).
 The layout must also be referenced in `srcs/juloo.keyboard2/Config.java` in
 `layoutId_of_string`.
 
+Keys with a name starting in `loc ` are hidden unless they are configured for
+the user's installed languages in `res/xml/method.xml`. These keys are optional
+and will be added automatically when necessary.
+
 Some users cannot easily type the characters close the the edges of the screen
 due to a bulky phone case. It is best to avoid placing important characters
 there (such as the digits or punctuation).
-- 
cgit v1.2.3