.

go/neo/xneo/parttab.go

@@ -34,7 +34,7 @@ import (
 //
 //	oid -> []uuid
 //
-// mapping associating object id with list of storage nodes on where data for
+// mapping associating object ID with list of storage nodes on where data for
 // this oid should be written-to/loaded-from. This mapping is organized as follows:
 //
 // Oid space is divided (partitioned) into Np parts via

go/neo/xneo/xneo.go

@@ -39,9 +39,13 @@ import (
 	"lab.nexedi.com/kirr/neo/go/neo/proto"
 )
 
-// NodeApp is base for implementing NEO node applications.
+// NodeApp provides base functionality underlying any NEO node.	XXX -> NodeBase? NodeSrv? NodeInstance?
 //
-// XXX -> internal?
+// Every node knows how to talk to master and receives master idea about:
+//
+// - current node table       (all nodes in the cluster),
+// - current partition table  (how data is split around storage nodes),
+// - current cluster state.
 type NodeApp struct {
 	MyInfo		proto.NodeInfo
 	ClusterName	string