diff --git a/api.txt b/api.txt
index 2d05099..86e2eeb 100644
--- a/api.txt
+++ b/api.txt
@@ -14,7 +14,8 @@ Make sure any mods using this function has 'hopper' in the depends.txt file.
 hopper:add_container({ {"where_from", "node_name", "inventory_name"} })
 
   'where_from' is a string telling the api that items are coming from either
-               the 'top', going to the 'bottom' or coming from the 'side'.
+               the 'top' node into a hopper, going into the 'bottom' node from a
+               hopper or coming from a 'side' hopper into a container.
 
   'node_name"  is the name of the container itself (e.g. "default:chest")
 
@@ -23,9 +24,9 @@ hopper:add_container({ {"where_from", "node_name", "inventory_name"} })
 e.g.
 
 hopper:add_container({
-	{"top", "default:furnace", "dst"}, -- take cooked items into hopper
-	{"bottom", "default:furnace", "src"}, -- insert items to be cooked from hopper
-	{"side", "default:furnace", "fuel"}, -- replenish furnace fuel from hopper
+	{"top", "default:furnace", "dst"}, -- take cooked items from above into hopper
+	{"bottom", "default:furnace", "src"}, -- insert items below to be cooked from hopper
+	{"side", "default:furnace", "fuel"}, -- replenish furnace fuel from hopper at side
 })