diff --git a/examples/scratchnet.py b/examples/scratchnet.py
index d8379da..a8de87a 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 c20aef3..ea053fa 100755
--- a/examples/scratchnetuser.py
+++ b/examples/scratchnetuser.py
@@ -5,6 +5,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.
+
 This version uses the user datapath and an explicit control network.
 """