diff --git a/docs/objects.rst b/docs/objects.rst
index a07736b..dd849bb 100644
--- a/docs/objects.rst
+++ b/docs/objects.rst
@@ -220,8 +220,8 @@ Creating blobs
 --------------------
 
 .. automethod:: pygit2.Repository.create_blob
-.. automethod:: pygit2.Repository.create_blob_fromfile
-
+.. automethod:: pygit2.Repository.create_blob_fromworkdir
+.. automethod:: pygit2.Repository.create_blob_fromdisk
 
 Tags
 =================
diff --git a/src/repository.c b/src/repository.c
index 6b9c446..bbe1bcf 100644
--- a/src/repository.c
+++ b/src/repository.c
@@ -578,7 +578,7 @@ Repository_create_blob(Repository *self, PyObject *args)
 PyDoc_STRVAR(Repository_create_blob_fromworkdir__doc__,
   "create_blob_fromworkdir(path) -> bytes\n"
   "\n"
-  "Create a new blob from a file within the working directory.");
+  "Create a new blob from a file within the working directory (raise an error otherwise).");
 
 PyObject *
 Repository_create_blob_fromworkdir(Repository *self, PyObject *args)
@@ -601,7 +601,7 @@ Repository_create_blob_fromworkdir(Repository *self, PyObject *args)
 PyDoc_STRVAR(Repository_create_blob_fromdisk__doc__,
   "create_blob_fromdisk(path) -> bytes\n"
   "\n"
-  "Create a new blob from file.");
+  "Create a new blob from a file anywhere (no working directory check).");
 
 PyObject *
 Repository_create_blob_fromdisk(Repository *self, PyObject *args)