diff --git a/report/node.go b/report/node.go
index a9dac1810..28386e3e6 100644
--- a/report/node.go
+++ b/report/node.go
@@ -6,9 +6,9 @@ import (
 	"github.com/weaveworks/common/mtime"
 )
 
-// Node describes a superset of the metadata that probes can collect about a
-// given node in a given topology, along with the edges emanating from the
-// node and metadata about those edges.
+// Node describes a superset of the metadata that probes can collect
+// about a given node in a given topology, along with the edges (aka
+// adjacency) emanating from the node.
 type Node struct {
 	ID             string                   `json:"id,omitempty"`
 	Topology       string                   `json:"topology,omitempty"`
diff --git a/report/topology.go b/report/topology.go
index 914bea5f9..4f94e54f5 100644
--- a/report/topology.go
+++ b/report/topology.go
@@ -5,9 +5,8 @@ import (
 	"strings"
 )
 
-// Topology describes a specific view of a network. It consists of nodes and
-// edges, and metadata about those nodes and edges, represented by
-// EdgeMetadatas and Nodes respectively. Edges are directional, and embedded
+// Topology describes a specific view of a network. It consists of
+// nodes with metadata, and edges. Edges are directional, and embedded
 // in the Node struct.
 type Topology struct {
 	Shape             string            `json:"shape,omitempty"`