From f9ae5792cc091c386df482d0dd6c71390c4ac195 Mon Sep 17 00:00:00 2001
From: Steve Clement <steve@localhost.lu>
Date: Fri, 12 Jan 2018 16:59:07 +0100
Subject: [PATCH] - More details and examples

---
 translation/README.md | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/translation/README.md b/translation/README.md
index 5eb8b8d..3d74106 100644
--- a/translation/README.md
+++ b/translation/README.md
@@ -4,9 +4,27 @@
 
 Please read the following CakePHP documentation about i18n & l10n: https://book.cakephp.org/2.0/en/core-libraries/internationalization-and-localization.html
 
-## Add an .md per translation effort
+## Add one .md per translation effort
 
-Please add a file à la: ja_JP.md (Japanese_Japan) or it_CH.md (Italian_Switzerland), in which you briefly describe what the current status is and what has been translated and which parts might be gotchas.
+Please add a file à la: ja_JP.md (Japanese_Japan) or it_CH.md (Italian_Switzerland), in which you briefly describe what the current status of your translation effort is and what has been translated and which parts might be gotchas.
+
+## Style
+
+Please follow whatever is the purest and most intelligible form of written language.
+
+## Formatting
+
+It is important to use correct formatting. This is wrong:
+
+```
+<p><?php echo __('Are you sure you want to delete Proposal #') . $id . '?' ?></p>
+```
+
+You want to have ultimate flexibility and that line should look more like this:
+
+```
+<p><?php echo __('Are you sure you want to delete Proposal #%s?', $id);?></p>
+```
 
 ## Let us know!