docs(hook): add documentation for version hooks

README.md

@@ -338,7 +338,23 @@ You might also need to adjust `changelog_path` in `cog.toml`.
 
 ## Run pre bump hook
 
-*Comming soon*
+Creating git tag automatically is great but sometimes you need to edit some file with the new version number,
+or perform some additional checks before doing so. 
+
+A typical example is editing your project manifest in your package manager configuration file.
+You can run pre bump commands with the `%version` alias to reference the newly created version :
+
+```toml
+# cog.toml
+hooks = [
+    "cargo build --release",
+    "cargo bump %version",
+]
+```
+
+When running `cog bump` these command will be run before creating the version commit.
+Assuming we are bumping to `1.1.0`, the `%version` alias will be replaced with `1.1.0`.
+
 
 ### Install pre commit hook
 

cog.toml

@@ -17,7 +17,10 @@ changelog_path = "CHANGELOG.md"
 # A list of command to run before creating a version.
 # All change generated by those commands will be committed with the generated version commit.
 # `%version` will be interpretted as your target version
-hooks = ["cargo bump %version"]
+hooks = [
+    "cargo build --release",
+    "cargo bump %version",
+]
 
 # An optional list of additional allowed commit type
 # `coco {commit_type}` commit command will be generated at runtime