diff --git a/examples/scratchnet.py b/examples/scratchnet.py
index d8379dadad851ee248ba9e71e8b8a5572939ea3b..a8de87a20afa47792525c3daeaf966681d99f484 100755
--- a/examples/scratchnet.py
+++ b/examples/scratchnet.py
@@ -4,6 +4,8 @@
 Build a simple network from scratch, using mininet primitives.
 This is more complicated than using the higher-level classes,
 but it exposes the configuration details and allows customization.
+
+For most tasks, the higher-level API will be preferable.
 """
 
 from mininet.net import init
diff --git a/examples/scratchnetuser.py b/examples/scratchnetuser.py
index c20aef3ab41fc4f542711c6a088657c07d525679..ea053fae3885862b5cd470a236a520bc28b02be3 100755
--- a/examples/scratchnetuser.py
+++ b/examples/scratchnetuser.py
@@ -5,6 +5,8 @@
 This is more complicated than using the higher-level classes,
 but it exposes the configuration details and allows customization.
 
+For most tasks, the higher-level API will be preferable.
+
 This version uses the user datapath and an explicit control network.
 """