diff --git a/phpBB/docs/coding-guidelines.html b/phpBB/docs/coding-guidelines.html index d5fde0fbc9..cedf03ba9b 100644 --- a/phpBB/docs/coding-guidelines.html +++ b/phpBB/docs/coding-guidelines.html @@ -79,6 +79,8 @@
  1. Standardisation
  2. Other considerations
    3. +
  3. Working with placeholders
    4. +
  4. Using plurals
  5. Writing Style
@@ -2341,7 +2343,7 @@ if (utf8_case_fold_nfc($string1) == utf8_case_fold_nfc($string2))

Within some cases, there may be mixed scripts of a left-to-right and right-to-left direction, so using LRE & RLE with PDF may be more appropriate. Lastly, in very rare instances where directionality must be forced, then use LRO & RLO with PDF.

For further information on authoring techniques of bi-directional text, please see the W3C tutorial on authoring techniques for XHTML pages with bi-directional text.

-

Working with placeholders:

+

6.iii. Working with placeholders

As phpBB is translated into languages with different ordering rules to that of English, it is possible to show specific values in any order deemed appropriate. Take for example the extremely simple "Page X of Y", whilst in English this could just be coded as:

@@ -2373,7 +2375,7 @@ if (utf8_case_fold_nfc($string1) == utf8_case_fold_nfc($string2)) ... -

Using plurals:

+

6.iv. Using plurals

The english language is very simple when it comes to plurals.
@@ -2382,7 +2384,7 @@ if (utf8_case_fold_nfc($string1) == utf8_case_fold_nfc($string2)) You have [1/21/31] slon, [2/3/4] slona, [0/5/6] slonova and [7/8/9/11] ... and some more difficult rules.

-

Therefor we introduced a plural system that deals with this kind of problems.

+

The plural system takes care of this and can be used as follows:

The PHP code will basically look like this:

@@ -2425,7 +2427,7 @@ if (utf8_case_fold_nfc($string1) == utf8_case_fold_nfc($string2)) ... -

6.iii. Writing Style

+

6.v. Writing Style

Miscellaneous tips & hints: