diff --git a/docs/source/markdown/options/network.md b/docs/source/markdown/options/network.md
index f2eec7a28b..faad284a4e 100644
--- a/docs/source/markdown/options/network.md
+++ b/docs/source/markdown/options/network.md
@@ -74,3 +74,6 @@ Valid _mode_ values are:
     - **pasta:-T,5201**: enable forwarding of TCP port 5201 from container to
         host, using the loopback interface instead of the tap interface for improved
         performance
+
+    NOTE: For backward compatibility reasons, if you have a network named `pasta`,
+    Podman will use this instead of the pasta mode.
diff --git a/docs/source/markdown/podman-network-create.1.md b/docs/source/markdown/podman-network-create.1.md
index 6fd31dd4d1..4dc47db35c 100644
--- a/docs/source/markdown/podman-network-create.1.md
+++ b/docs/source/markdown/podman-network-create.1.md
@@ -15,6 +15,9 @@ If no options are provided, Podman will assign a free subnet and name for your n
 
 Upon completion of creating the network, Podman will display the name of the newly added network.
 
+NOTE: The support for the network name pasta is deprecated and will be removed in the next major
+release because it is used as a special network mode in **podman run/create --network**.
+
 ## OPTIONS
 #### **--disable-dns**