diff --git a/release/README.md b/release/README.md
index e1e6420357..64485be48b 100644
--- a/release/README.md
+++ b/release/README.md
@@ -1,8 +1,15 @@
 # Release tools
 
+* [Introduction](#introduction)
+* [`update-repository-version.sh`](#update-repository-versionsh)
+* [Update Kata projects to a new version](#update-kata-projects-to-a-new-version)
+* [`tag_repos.sh`](#tag_repossh)
+
+## Introduction
+
 This directory contains tools for Kata Containers releases.
 
-## update-repository-version.sh
+## `update-repository-version.sh`
 
 This script creates a GitHub pull request (a.k.a PR) to change the version in
 all the Kata repositories.
@@ -24,12 +31,12 @@ To update all versions for all projects, use the following:
 $ make bump-kata-version NEW_VERSION=<new-version>
 ```
 
-The makefile target bump-kata-version creates a GitHub pull request in the Kata
-repositories. These pull requests are tested by the Kata CI to ensure the
+The makefile target `bump-kata-version` creates a GitHub pull request in the
+Kata repositories. These pull requests are tested by the Kata CI to ensure the
 entire project is working prior to the release. Next, the PR is approved and
 merged by Kata Containers members.
 
-## tag_repos.sh
+## `tag_repos.sh`
 
 After all the Kata repositories are updated with a new version, they need to be
 tagged.