docs: update comments

Author: georgeh0

.github/workflows/release.yml

@@ -1,8 +1,7 @@
-# This file is autogenerated by maturin v1.8.1
-# To update, run
-#
-#    maturin generate-ci github
+# This workflow can be triggered on tags push (automatic release) or manually on any branch.
 #
+# - When triggered on tags push, it will build and publishes a new version including docs.
+# - When triggered manually, it's a dry-run: only build, without publishing anything.
 name: release
 
 on: