updated PM docs
-# CIB format
+The Characteristics Information Base (CIB) is a repository that stores information about hosts (e.g., available interfaces, supported protocols), connections (e.g., parameters used by previously established transport sessions, hosts currently communicating) and the network (e.g., path properties). CIB entries provide measured information, protocol details and capabilities about network entities used in the NEAT System, specifically in the policy decision phase.
+
+The NEAT CIB acts as a filter of potential connection candidates.
-The NEAT CIB is a repository containing a list of potential candidates for new connections.
+# CIB format
Each entry or *row* of the CIB is comprised of an arbitrary number of *NEAT Properties*. Rows are composed from one or more *CIB nodes* represented as JSON objects - and, e.g., stored as files in the CIB directory or received through the REST API. These JSON objects are generated by various helper applications called *CIB sources*. A simple example of the CIB node defining a local interface is given below:
