diff --git a/apiary.apib b/apiary.apib
index 630b499..2febe4d 100644
--- a/apiary.apib
+++ b/apiary.apib
@@ -5823,9 +5823,9 @@ merkledag root.
 + Parameters
     + arg (string, required) - Path to write to.
     + arg2 (string, required) - Data to write.
-    + offset (number, optional)  - Offset to write to. Alias: o.
+    + offset (number, optional)  - Byte offset to begin writing at. Alias: o.
     + create (number, optional) - Create the file if it does not exist. Alias: e.
-    + truncate (boolean, optional) - Truncate the file before writing. Alias: t.
+    + truncate (boolean, optional) - Truncate the file to size zero before writing. Alias: t.
     + count (number, optional) - Maximum number of bytes to read. Alias: n.
     + flush (boolean, optional) - Flush target and ancestors after write. Default: true. Alias: f.