diff --git a/README.md b/README.md
index 5155ac0..e60f192 100644
--- a/README.md
+++ b/README.md
@@ -76,11 +76,11 @@ See examples of using `cache` and `cache-dependency-path` for `pipenv` and `poet
 
 ## Advanced usage
 
-- [Using python-version input](docs/advanced-usage.md#using-python-version-input)
-- [Using python-version-file input](docs/advanced-usage.md#using-python-version-file-input)
+- [Using the python-version input](docs/advanced-usage.md#using-the-python-version-input)
+- [Using the python-version-file input](docs/advanced-usage.md#using-the-python-version-file-input)
 - [Check latest version](docs/advanced-usage.md#check-latest-version)
-- [Caching packages data](docs/advanced-usage.md#caching-packages-data)
-- [Environment variables and action's outputs](docs/advanced-usage.md#environment-variables-and-actions-outputs)
+- [Caching packages](docs/advanced-usage.md#caching-packages)
+- [Outputs and environment variables](docs/advanced-usage.md#outputs-and-environment-variables)
 - [Available versions of Python and PyPy](docs/advanced-usage.md#available-versions-of-python-and-pypy)
 - [Hosted tool cache](docs/advanced-usage.md#hosted-tool-cache) 
 - [Using `setup-python` with a self-hosted runner](docs/advanced-usage.md#using-setup-python-with-a-self-hosted-runner)
diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md
index 7138ba9..024e8b1 100644
--- a/docs/advanced-usage.md
+++ b/docs/advanced-usage.md
@@ -1,12 +1,15 @@
 # Advanced Usage
-- [Using python-version input](advanced-usage.md#using-python-version-input)
+- [Using the python-version input](advanced-usage.md#using-the-python-version-input)
     - [Specifying a Python version](advanced-usage.md#specifying-a-python-version)
     - [Specifying a PyPy version](advanced-usage.md#specifying-a-pypy-version)
     - [Matrix Testing](advanced-usage.md#matrix-testing)
-- [Using python-version-file input](advanced-usage.md#using-python-version-file-input)
+- [Using the python-version-file input](advanced-usage.md#using-the-python-version-file-input)
 - [Check latest version](advanced-usage.md#check-latest-version)
-- [Caching packages data](advanced-usage.md#caching-packages-data)
-- [Environment variables and action's outputs](advanced-usage.md#environment-variables-and-actions-outputs)
+- [Caching packages](advanced-usage.md#caching-packages)
+- [Outputs and environment variables](advanced-usage.md#outputs-and-environment-variables)
+    - [Outputs](advanced-usage.md#outputs)
+    - [Environment variables](advanced-usage.md#environment-variables)
+    - [Using update-environment flag](advanced-usage.md#using-update-environment-flag)
 - [Available versions of Python and PyPy](advanced-usage.md#available-versions-of-python-and-pypy)
     - [Python](advanced-usage.md#python)
     - [PyPy](advanced-usage.md#pypy)