Perry J Oakes
Update 'README.md' Reviewed-on: #1283
This is the repository for the unfoldingWord® Translation Words (UTW) resource.
UTW is a basic Bible dictionary that is based on the English vocabulary of the ULT. We intend that it will be translated into other Gateway Languages, each of which will be based on the vocabulary of the GLT in that language. Its purpose is to provide translators with concise definitions of important or difficult biblical concepts, along with translation suggestions for those concepts, to help them make sound translation decisions.
While based on English vocabulary, UTW will seek to organize its definitions by concept, in order to allow GL translators to more easily sort and combine the concepts into the categories and vocabulary of their own Gateway Languages. This means that an English word with multiple sentences will yield one UTW article for each sense. GL translators can then take these articles and arrange them under the appropriate head word or words of their own language.
In order to not burden the translator unneccessarily with definitions of routine vocabulary, UTW articles will be limited to the following categories of key or difficult concepts. Concepts that qualify for a UTW article are:
It is important to note that UTW is only one component in a set of translation tools and resources. It is not intended to cover everything, but only the concepts as described above. It is also important to note that UTW is not based on Hebrew, Aramaic, or Greek and does not provide definitions of terms from those languages. The unfoldingWord® Hebrew and Aramaic Lexicon (UHAL) and the unfoldingWord® Greek Lexicon (UGL) will do that.
The two “front-line” checking tools based on UTW and UTN are also complementary and are most useful for the translator when they remain distinct. For that reason, both resources are limited to their own domains. UTW is limited to the categories of key and difficult concepts, and UTN is limited to the categories of difficulties specified for it (figures of speech, grammar, etc.).
The value of UTW for translators is to provide definitions for general concepts that they will find difficult to translate. A primary differentiator between UTW and UTN is that UTN addresses individual, verse-specific difficulties. It speaks to the exact problem in the exact context, many of which may only occur once in the Bible. For example, a UTN metaphor check is backstopped by the general UTA article on metaphor, but the specific note explains the specific metaphor that may be unique to that verse and occur nowhere else. The tool based on UTW, on the other hand, addresses concepts that recur constantly throughout the Bible, so the help that it gives is much more general, and one article may apply dozens of times, even in the same book. The strength of checking with this tool is that it allows translators to see each instance of a recurring concept in its context, but gathered into one place where the translation of each one can be compared side-by-side for appropriateness and consistency.
Please use the issue queue to provide feedback or suggestions for improvement.
If you want to make your suggested changes then you may use the online editor to do so. See the protected branch workflow document for step by step instructions.
The tWs are organized into three sub directories under
ktcontains “key terms” which we consider to be of special importance in the Bible.
othercontains terms which require explanation but are of less importance than the “key terms.”
namescontains proper names of people and places in the Bible.
See the LICENSE file for licensing information.