diff --git a/.gitignore b/.gitignore
index baff153..371615d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,3 +4,4 @@ sites/*/settings*.php
 # Ignore paths that contain user-generated content.
 sites/*/files
 sites/*/private
+/nbproject/private/
\ No newline at end of file
diff --git a/modules/node/node.api.php b/modules/node/node.api.php
index f8dcfde..99852eb 100644
--- a/modules/node/node.api.php
+++ b/modules/node/node.api.php
@@ -1033,9 +1033,17 @@ function hook_node_type_delete($info) {
  * This hook is invoked only on the module that defines the node's content type
  * (use hook_node_delete() to respond to all node deletions).
  *
- * This hook is invoked from node_delete_multiple() after the node has been
- * removed from the node table in the database, before hook_node_delete() is
- * invoked, and before field_attach_delete() is called.
+ * This hook is invoked from node_delete_multiple() before hook_node_delete() 
+ * is invoked and before field_attach_delete() is called. 
+ * 
+ * Note that when this hook is invoked, the changes have not yet been written 
+ * to the database, because a database transaction is still in progress. The 
+ * transaction is not finalized until the delete operation is entirely 
+ * completed and node_delete_multiple() goes out of scope. You should not rely 
+ * on data in the database at this time as it is not updated yet. You should 
+ * also note that any write/update database queries executed from this hook are 
+ * also not committed immediately. Check node_delete_multiple() and 
+ * db_transaction() for more info.
  *
  * @param $node
  *   The node that is being deleted.
