diff --git a/docs/rolereference.rst b/docs/rolereference.rst
index 85974dd36b87f47a49e64d32c1e4ffde0063609e..8fb593525d6515ae58a4d122623cbe369a593535 100644
--- a/docs/rolereference.rst
+++ b/docs/rolereference.rst
@@ -197,6 +197,7 @@ hardening across all servers, no matter what services they provide.
 
 The role implements the following:
 
+* Configures apt to use caching proxy (if any was specified).
 * Sets-up umask for all logins to ``0027``.
 * Installs sudo.
 * Installs additional base packages, as configured.
@@ -220,6 +221,10 @@ The role implements the following:
 Parameters
 ~~~~~~~~~~
 
+**apt_proxy** (string, optional)
+  URI of a caching proxy that should be used when retrieving the packages via
+  apt. Default is no proxy.
+
 **os_users** (list, optional)
   A list of operating system users that should be set-up on a server. Each item
   is a dictionary with the following options describing the user parameters: