diff --git a/CHANGELOG.md b/CHANGELOG.md
index ba0cb4ea8..291c58889 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,8 +5,19 @@ v0.27 + 1
 
 ### API additions
 
+* `git_commit_create_on()` takes on the role which
+  `git_commit_create()` had when provided a reference name to
+  update. `git_commit_create_on_head()` always updates the current
+  branch.
+
+* `git_commit_create_fromstate()` is a variant of the commit creation
+  function which behaves closer to `git-commit` by taking the parents
+  and tree from the current branch and the index.
+
 ### API removals
 
+* `git_commit_create()` has been renamed to `git_commit_create_on()`.
+
 ### Breaking API changes
 
 v0.27