Samuel_Kim_en_uhg/content/front.rst

:github_url: https://git.door43.org/unfoldingWord/en_uhg/src/branch/master/content/front.rst

.. _front:

unfoldingWord Hebrew Grammar
============================

Introduction
------------

The unfoldingWord Hebrew Grammar (UHG) is a Biblical Hebrew reference grammar
based on the `morphology codes <http://openscriptures.github.io/morphhb/parsing/HebrewMorphologyCodes.html>`__
that appear in the `Open Scriptures Hebrew Bible (OSHB) <https://github.com/openscriptures/morphhb>`__. It enables the
global Church to gain the best possible understanding of the Hebrew
grammar of the Old Testament.

Rationale
---------

The rationale behind creating the first version of the UHG was to
provide an openly licensed and up to date reference grammar for direct
use with the OSHB. Such a grammar may be used in
software to provide students and translators of Scripture with up to
date and accurate descriptions of Hebrew grammar on an as needed basis.
Because the articles are directly patterned after the morphological
categories of the OSHB, it is easy for software to link directly to
them.

Methodology
-----------

A team of scholars and technicians worked together to create and revise
each of the articles in the UHG over the course of a year and a half.
The creation process included individuals drafting glossary and article
entries for each grammatical topic and then a series of peer reviews of
each. Several meetings were held to help standardize the format of the
articles and to discuss difficult issues as they arose.

The differentiation between the glossary entries and the articles is
similar to the approach of many Wikipedia articles. The glossary entry
is a one or two sentence summary of the grammatical topic, while the
article goes into much more detail and includes several examples. This
has the effect of being useful in a pop up or tooltip in software
applications, which may provide immediate access to the glossary in the
pop up and then link to the full article.

A unique design goal was to make the language of the grammar as simple
as possible so that the resource can more easily be translated into the
`Gateway Languages <https://unfoldingword.org/gateway/>`__ of the world.
This should also have the effect of rendering the grammar accessible to
people of varied educational backgrounds and varied proficiency in the
English language.

The work was completed using an online content creation and translation
platform, the `Door43 Content Service <https://git.door43.org>`__.
Because of this, all the work is under revision control, you can go back
and see the `commit history <https://git.door43.org/unfoldingWord/en_uhg/commits/branch/master>`__
if you'd like (it totals over 2500 commits at the time of writing).

Future
------

We plan to extend the UHG, in conjunction with the unfoldingWord Hebrew
Bible, to cover higher level syntactic and semantic information. Rather
than replacing the existing form-centric morphology of the OSHB, we
would add another parsing layer on top of it that focuses on the
function of the words and phrases. This will generate a new list of
categories that will need explanations in the UHG. Some examples of new
categories are discourse markers, specific uses of imperfect forms,
context sensitive gender identification and the like.

A further extension may be to take the raw material from this work and
augment and format it to be useful as a teaching grammar. Again, the
idea here would be to provide a resource that could easily be translated
and adapted into other Gateway Languages.

If either of these ideas intrigue you, let us know at
https://unfoldingword.org/contact/, we'd love to have your involvement!

Downloads
---------

The latest version of the UHG may be downloaded in the following formats:

- `UHG HTML <https://readthedocs.org/projects/uhg/downloads/htmlzip/latest/>`__
- `UHG reStructuredText source files <https://git.door43.org/unfoldingWord/en_uhg/archive/master.zip>`__

Contributors
------------

This resource was designed by the `unfoldingWord Project <https://unfoldingword.org/>`__ and built by the `Door43 World Missions Community <https://door43.org/>`__. At least the following
people were instrumental in the creation of the UHG:

-  Bram van den Heuvel (BA Theology, Utrecht University; MA Biblical
   Studies, Utrecht University / University of Amsterdam; Ph.D.
   Candidate Old Testament, Evangelische Theologische Faculteit)
-  Chapel Presson (BA Pre-Seminary Studies/Bible, Central Bible College;
   MDiv, Liberty Baptist Theological Seminary)
-  Daniel Bowman (BA Ancient Languages, Cornerstone University; MDiv,
   Grand Rapids Theological Seminary)
-  Ethan Knapp
-  Joel D. Ruark (M.A.Th. Gordon-Conwell Theological Seminary; Th.M.
   Stellenbosch University; Ph.D. Candidate in Old Testament Studies,
   Stellenbosch University)
-  Jesse Griffin (BA Biblical Studies, Liberty University; MA Biblical
   Languages, Gordon-Conwell Theological Seminary)
-  Kenny E. Hilliard III (BA Christian Studies, North Greenville
   University; MDiv Christian Ministry: Biblical Languages, Southeastern
   Baptist Theological Seminary; PHD Candidate Biblical Studies: Old
   Testament, Southeastern Baptist Theological Seminary)
-  Perry Oakes (BA Biblical Studies, Taylor University; MA Theology,
   Fuller Seminary; MA Linguistics, University of Texas at Arlington;
   PhD Old Testament, Southwestern Baptist Theological Seminary)
-  Stephen J. Andrews (BA Carson-Newman; M.Div. Eastern Baptist
   Theological Seminary; Th.M. Southeastern Baptist Theological
   Seminary; Ph.D. Hebrew Union College)

License
-------

Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is a human-readable summary of (and not a substitute for) the
`license <http://creativecommons.org/licenses/by-sa/4.0/>`__.

You are free to:
^^^^^^^^^^^^^^^^

-  **Share** — copy and redistribute the material in any medium or
   format
-  **Adapt** — remix, transform, and build upon the material

for any purpose, even commercially.

The licensor cannot revoke these freedoms as long as you follow the
license terms.

Under the following conditions:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

-  **Attribution** — You must attribute the work as follows: “Original
   work available at https://unfoldingword.org/uhg/.” Attribution
   statements in derivative works should not in any way suggest that we
   endorse you or your use of this work.
-  **ShareAlike** — If you remix, transform, or build upon the material,
   you must distribute your contributions under the same license as the
   original.

**No additional restrictions** — You may not apply legal terms or
technological measures that legally restrict others from doing anything
the license permits.

Notices:
^^^^^^^^

You do not have to comply with the license for elements of the material
in the public domain or where your use is permitted by an applicable
exception or limitation.

No warranties are given. The license may not give you all of the
permissions necessary for your intended use. For example, other rights
such as publicity, privacy, or moral rights may limit how you use the
material.