docs(lorem): define allowed words #2885
Conversation
xDivisionByZerox
added
c: docs
✅ Deploy Preview for fakerjs ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## next #2885 +/- ##
========================================
Coverage 99.95% 99.96%
========================================
Files 2977 2977
Lines 215466 215469 +3
Branches 597 951 +354
========================================
+ Hits 215372 215384 +12
+ Misses 94 85 -9
|
Oh wow, then I completly misunderstood what we discussed in the team meeting when we made the decision. Discuss again in tomorrows meeting? |
|
We should survey what current non-Latin locales actually do and document that (eg are they nonsense words or real words or transliterations of Latin lorem?) |
|
25 locales currently have a lorem/words.ts file. For each i generated 5 sample words Latin
Non-latin(im not really enough of an expert in non-Latin languages to tell if these are nonsense or real words)
|
There was a problem hiding this comment.
Suggested rewrite. In some ways the concept of "lorem ipsum" is unique to Latin-based languages, because you can write words using Ancient Latin, a dead language, that are "foreign" and yet immediately obvious as "words" in most Latin-based languages.
So I'm not sure there's a definite "best" way to handle lorem-ipsum in non-Latin languages. In some languages it may make sense to transliterate Latin words into the script like "l-o-r-e-m", in other cases you may just want to us random words or characters.
| @@ -2,6 +2,9 @@ import type { LocaleEntry } from './definitions'; | |||
|
|
|||
| /** | |||
| * The possible definitions related to lorem texts. | |||
| * | |||
| * The words in this module are determined by the ISO 15924 script of the locale. | |||
| * If a locale uses the Latin script, it will utilize Latin lorem words, while a locale using the Cyrillic script will use Cyrillic lorem words, and so forth. | |||
There was a problem hiding this comment.
| * If a locale uses the Latin script, it will utilize Latin lorem words, while a locale using the Cyrillic script will use Cyrillic lorem words, and so forth. | |
| * If a locale uses the Latin script, it should generally utilize Latin "lorem ipsum" words, while a locale using another script should use real or nonsense words to give the same effect as Latin lorem text. |
|
Team Proposal
|
Description
Document the expected words for a locale in the lorem module.
Related to
This is the first part of #2884.