diff --git a/docs/api.rst b/docs/api.rst
index 9eac0d1e1955..7422a73cf725 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -2141,7 +2141,7 @@ and XLIFF.
        The ``target`` and ``source`` are now arrays to properly handle plural
        strings.
 
-    Returns information about translation unit.
+    Returns information about the translation unit.
 
     :param id: Unit ID
     :type id: int
@@ -2156,7 +2156,7 @@ and XLIFF.
     :>json string note: translation unit note
     :>json string flags: translation unit flags
     :>json array labels: translation unit labels, available on source units
-    :>json int state: unit state, 0 - untranslated, 10 - needs editing, 20 - translated, 30 - approved, 100 - read only
+    :>json int state: unit state, 0 - untranslated, 10 - needs editing, 20 - translated, 30 - approved, 100 - read-only
     :>json boolean fuzzy: whether the unit is fuzzy or marked for review
     :>json boolean translated: whether the unit is translated
     :>json boolean approved: whether the translation is approved