Added high-level overview docs to each of the top-level component classes.

Bryan Worrell · Bryan Worrell · commit 12d3912c8154 · 2015-05-14T09:10:42.000-04:00
diff --git a/docs/api/campaign/campaign.rst b/docs/api/campaign/campaign.rst
@@ -3,6 +3,20 @@
 
 .. module:: stix.campaign
 
+Overview
+--------
+
+The :mod:`stix.campaign` module implements :class:`.Campaign`.
+
+Campaigns are instances of ThreatActors pursuing an intent, as observed through
+sets of Incidents and/or TTP, potentially across organizations.
+
+
+Documentation Resources
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* `Campaign Data Model <http://stixproject.github.io/data-model/1.2/campaign/CampaignType/>`_
+
 Classes
 -------
 
diff --git a/docs/api/coa/coa.rst b/docs/api/coa/coa.rst
@@ -1,8 +1,24 @@
 :mod:`stix.coa` Module
-==================================
+======================
 
 .. module:: stix.coa
 
+Overview
+--------
+
+The :mod:`stix.coa` module implements :class:`.CourseOfAction`.
+
+CoursesOfAction are specific measures to be taken to address threat whether
+they are corrective or preventative to address ExploitTargets, or responsive to
+counter or mitigate the potential impacts of Incidents
+
+
+Documentation Resources
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* `Course Of Action Data Model <http://stixproject.github.io/data-model/1.2/coa/CourseOfActionType/>`_
+
+
 Classes
 -------
 
diff --git a/docs/api/exploit_target/exploit_target.rst b/docs/api/exploit_target/exploit_target.rst
@@ -5,15 +5,18 @@
 
 Overview
 --------
-The :mod:`stix.exploit_target` module implements ``ExploitTarget``.
-This denotes the specific vulnerability, weakness, or software configuration that creates a security risk.
+
+The :mod:`stix.exploit_target` module implements :class:`.ExploitTarget`.
+
+This denotes the specific vulnerability, weakness, or software configuration
+that creates a security risk.
 
 
 Documentation Resources
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-* `ExploitTarget Data Model <https://stixproject.github.io/data-model/1.2/et/ExploitTargetType/>`_
-* `ExploitTarget Idioms <https://stixproject.github.io/documentation/idioms/cve/>`_
+* `Exploit Target Data Model <https://stixproject.github.io/data-model/1.2/et/ExploitTargetType/>`_
+* `Exploit Target Idioms <https://stixproject.github.io/documentation/idioms/cve/>`_
 
 Classes
 -------
diff --git a/docs/api/incident/incident.rst b/docs/api/incident/incident.rst
@@ -1,8 +1,22 @@
 :mod:`stix.incident` Module
-==================================
+===========================
 
 .. module:: stix.incident
 
+Overview
+--------
+
+The :mod:`stix.incident` module implements :class:`.Incident`.
+
+Incidents are discrete instances of Indicators affecting an organization along
+with information discovered or decided during an incident response investigation.
+
+
+Documentation Resources
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* `Incident Data Model <https://stixproject.github.io/data-model/1.2/incident/IncidentType/>`_
+
 Classes
 -------
 
diff --git a/docs/api/report/report.rst b/docs/api/report/report.rst
@@ -3,6 +3,20 @@
 
 .. module:: stix.report
 
+Overview
+--------
+
+The :mod:`stix.report` module implements :class:`.Report`.
+
+A Report defines a contextual wrapper for a grouping of STIX content.
+
+
+Documentation Resources
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* `Report Data Model <https://stixproject.github.io/data-model/1.2/report/ReportType/>`_
+
+
 Classes
 -------
 
diff --git a/docs/api/threat_actor/threat_actor.rst b/docs/api/threat_actor/threat_actor.rst
@@ -3,6 +3,22 @@
 
 .. module:: stix.threat_actor
 
+Overview
+--------
+
+The :mod:`stix.threat_actor` module implements :class:`.ThreatActor`.
+
+ThreatActors are characterizations of malicious actors (or adversaries)
+representing a cyber attack threat including presumed intent and historically
+observed behavior.
+
+
+Documentation Resources
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* `Threat Actor Data Model <https://stixproject.github.io/data-model/1.2/ta/ThreatActorType/>`_
+
+
 Classes
 -------
 
diff --git a/docs/api/ttp/ttp.rst b/docs/api/ttp/ttp.rst
@@ -1,8 +1,21 @@
 :mod:`stix.ttp` Module
-==================================
+======================
 
 .. module:: stix.ttp
 
+Overview
+--------
+
+The :mod:`stix.ttp` module implements :class:`.TTP`.
+
+TTPs are representations of the behavior or modus operandi of cyber adversaries.
+
+
+Documentation Resources
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* `TTP Data Model <https://stixproject.github.io/data-model/1.2/ttp/TTPType/>`_
+
 Classes
 -------
 
