diff --git a/README.md b/README.md
index 91bef3d95d..86d61e77fb 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,20 @@
+
[](https://travis-ci.org/apache/metron)
# Apache Metron
diff --git a/Upgrading.md b/Upgrading.md
index c3892ce1b1..66bba0ca3c 100644
--- a/Upgrading.md
+++ b/Upgrading.md
@@ -1,3 +1,20 @@
+
# Upgrading
This document constitutes a per-version listing of changes of
configuration which are non-backwards compatible.
diff --git a/build_utils/README.md b/build_utils/README.md
index dba2114a52..04087ee768 100644
--- a/build_utils/README.md
+++ b/build_utils/README.md
@@ -1,3 +1,20 @@
+
# Build Utilities
The aim of the build utilities project is to provide some scripting
diff --git a/metron-analytics/README.md b/metron-analytics/README.md
index d639ca339e..56a4b7506b 100644
--- a/metron-analytics/README.md
+++ b/metron-analytics/README.md
@@ -1,3 +1,20 @@
+
# Metron Analytics
Metron analytics consists of:
diff --git a/metron-analytics/metron-maas-service/README.md b/metron-analytics/metron-maas-service/README.md
index d23413069e..bd1d76c20d 100644
--- a/metron-analytics/metron-maas-service/README.md
+++ b/metron-analytics/metron-maas-service/README.md
@@ -1,3 +1,20 @@
+
# Model Management Infrastructure
## Introduction
diff --git a/metron-analytics/metron-profiler-client/README.md b/metron-analytics/metron-profiler-client/README.md
index 415605880e..9fe1f6ec72 100644
--- a/metron-analytics/metron-profiler-client/README.md
+++ b/metron-analytics/metron-profiler-client/README.md
@@ -1,3 +1,20 @@
+
# Metron Profiler Client
This project provides a client API for accessing the profiles generated by the [Metron Profiler](../metron-profiler). This includes both a Java API and Stellar API for accessing the profile data. The primary use case is to extract profile data for use during model scoring.
diff --git a/metron-analytics/metron-profiler/README.md b/metron-analytics/metron-profiler/README.md
index a24e3cf896..dc5ec07ce8 100644
--- a/metron-analytics/metron-profiler/README.md
+++ b/metron-analytics/metron-profiler/README.md
@@ -1,3 +1,20 @@
+
# Metron Profiler
The Profiler is a feature extraction mechanism that can generate a profile describing the behavior of an entity. An entity might be a server, user, subnet or application. Once a profile has been generated defining what normal behavior looks-like, models can be built that identify anomalous behavior.
diff --git a/metron-analytics/metron-statistics/HLLP.md b/metron-analytics/metron-statistics/HLLP.md
index c645253dfd..ed105b0123 100644
--- a/metron-analytics/metron-statistics/HLLP.md
+++ b/metron-analytics/metron-statistics/HLLP.md
@@ -1,3 +1,20 @@
+
# HyperLogLogPlus
## Preliminaries - Distinct Value (cardinality) Estimation
diff --git a/metron-analytics/metron-statistics/README.md b/metron-analytics/metron-statistics/README.md
index 508b612c63..1b83245516 100644
--- a/metron-analytics/metron-statistics/README.md
+++ b/metron-analytics/metron-statistics/README.md
@@ -1,3 +1,20 @@
+
# Statistics and Mathematical Functions
A variety of non-trivial and advanced analytics make use of statistics
diff --git a/metron-contrib/metron-docker/README.md b/metron-contrib/metron-docker/README.md
index 54cb63b38f..c290732383 100644
--- a/metron-contrib/metron-docker/README.md
+++ b/metron-contrib/metron-docker/README.md
@@ -1,3 +1,20 @@
+
# Metron Docker
Metron Docker is a [Docker Compose](https://docs.docker.com/compose/overview/) application that is intended only for development and integration testing of Metron. These images can quickly spin-up the underlying components on which Apache Metron runs.
diff --git a/metron-deployment/Kerberos-ambari-setup.md b/metron-deployment/Kerberos-ambari-setup.md
index 39e8dee849..2c6e0558e7 100644
--- a/metron-deployment/Kerberos-ambari-setup.md
+++ b/metron-deployment/Kerberos-ambari-setup.md
@@ -1,3 +1,20 @@
+
# Setting Up Kerberos in Vagrant Full Dev
**Note:** These are instructions for Kerberizing Metron Storm topologies from Kafka to Kafka. This does not cover the sensor connections or MAAS.
General Kerberization notes can be found in the metron-deployment [README.md](../README.md)
diff --git a/metron-deployment/Kerberos-manual-setup.md b/metron-deployment/Kerberos-manual-setup.md
index 5d44b2a9b9..9ebe40841d 100644
--- a/metron-deployment/Kerberos-manual-setup.md
+++ b/metron-deployment/Kerberos-manual-setup.md
@@ -1,3 +1,20 @@
+
Kerberos Setup
==============
diff --git a/metron-deployment/README.md b/metron-deployment/README.md
index 73e7e87494..0b9a6fe619 100644
--- a/metron-deployment/README.md
+++ b/metron-deployment/README.md
@@ -1,3 +1,20 @@
+
# Overview
This set of playbooks can be used to deploy an Ambari-managed Hadoop cluster containing Metron services using Ansible. These playbooks target RHEL/CentOS 6.x operating
systems.
diff --git a/metron-deployment/amazon-ec2/README.md b/metron-deployment/amazon-ec2/README.md
index 82b7aebadb..f34632d06c 100644
--- a/metron-deployment/amazon-ec2/README.md
+++ b/metron-deployment/amazon-ec2/README.md
@@ -1,3 +1,20 @@
+
Apache Metron on Amazon EC2
===========================
diff --git a/metron-deployment/other-examples/README.md b/metron-deployment/other-examples/README.md
index 5e2ef12173..88308eee95 100644
--- a/metron-deployment/other-examples/README.md
+++ b/metron-deployment/other-examples/README.md
@@ -1,3 +1,20 @@
+
# Other Example Deployments
This folder contains other example deployments which are not covered under the automatic installs.
These examples have been vetted and tested by the Metron community at the time of entry. However, development moves fast and things may change. If there are problems with these steps, please check the mailing lists first or log a Jira ticket.
diff --git a/metron-deployment/other-examples/manual-install/Manual_Install_CentOS6.md b/metron-deployment/other-examples/manual-install/Manual_Install_CentOS6.md
index e078a72d0b..0c9df5e217 100644
--- a/metron-deployment/other-examples/manual-install/Manual_Install_CentOS6.md
+++ b/metron-deployment/other-examples/manual-install/Manual_Install_CentOS6.md
@@ -1,3 +1,20 @@
+
[//]: # (Metron 0.4.0 bare metal installation guide for CentOS 6)
[//]: # (Written by Laurens Vets, laurens@daemon.be)
[//]: # (Version 0.3.3, July 2017)
diff --git a/metron-deployment/packaging/ambari/README.md b/metron-deployment/packaging/ambari/README.md
index af511b4d51..bdb8b499e2 100644
--- a/metron-deployment/packaging/ambari/README.md
+++ b/metron-deployment/packaging/ambari/README.md
@@ -1,3 +1,20 @@
+
# Ambari Management Pack Development
## Table of Contents
diff --git a/metron-deployment/packaging/docker/ansible-docker/README.md b/metron-deployment/packaging/docker/ansible-docker/README.md
index 1d0d22bdf7..910446b6c1 100644
--- a/metron-deployment/packaging/docker/ansible-docker/README.md
+++ b/metron-deployment/packaging/docker/ansible-docker/README.md
@@ -1,3 +1,20 @@
+
# Overview
The Metron ansible-docker container is provided in an effort reduce the installation burden of building Metron.
It may also be used to deploy Metron in a live environment.
diff --git a/metron-deployment/packaging/docker/deb-docker/README.md b/metron-deployment/packaging/docker/deb-docker/README.md
index 8ee867173f..800984b79c 100644
--- a/metron-deployment/packaging/docker/deb-docker/README.md
+++ b/metron-deployment/packaging/docker/deb-docker/README.md
@@ -1,4 +1,20 @@
-
+
This project builds DEB packages for installing Apache Metron on Ubuntu.
**WARNING**: The DEB packages are a recent addition to Metron. These packages have not undergone the same level of testing as the RPM packages. Improvements and more rigerous testing of these packages is underway and will improve in future releases. Until then, use these at your own risk.
diff --git a/metron-deployment/packaging/docker/rpm-docker/README.md b/metron-deployment/packaging/docker/rpm-docker/README.md
index d62b204639..e9fe2e6d87 100644
--- a/metron-deployment/packaging/docker/rpm-docker/README.md
+++ b/metron-deployment/packaging/docker/rpm-docker/README.md
@@ -1,3 +1,20 @@
+
# Overview
The Metron ansible-docker container is provided in an effort reduce the installation burden of deploying Metron in a live envirionment.
It is provisioned with software required to sucessfully run the deployment scripts.
diff --git a/metron-deployment/packaging/packer-build/README.md b/metron-deployment/packaging/packer-build/README.md
index 78217a022f..8cb5ff543c 100644
--- a/metron-deployment/packaging/packer-build/README.md
+++ b/metron-deployment/packaging/packer-build/README.md
@@ -1,3 +1,20 @@
+
Build Metron Images
=========================
diff --git a/metron-deployment/roles/README.md b/metron-deployment/roles/README.md
index ce6c3babc6..1cb5878e0a 100644
--- a/metron-deployment/roles/README.md
+++ b/metron-deployment/roles/README.md
@@ -1,3 +1,20 @@
+
# Ansible Roles
- Monit
diff --git a/metron-deployment/roles/monit/README.md b/metron-deployment/roles/monit/README.md
index bf52c5d693..6f508528d9 100644
--- a/metron-deployment/roles/monit/README.md
+++ b/metron-deployment/roles/monit/README.md
@@ -1,3 +1,20 @@
+
# Monit Integration
This role will leverage Monit as a process watchdog to manage sensors, topologies, and core services.
diff --git a/metron-deployment/roles/opentaxii/README.md b/metron-deployment/roles/opentaxii/README.md
index 52baa2cadd..7c111de0ae 100644
--- a/metron-deployment/roles/opentaxii/README.md
+++ b/metron-deployment/roles/opentaxii/README.md
@@ -1,3 +1,20 @@
+
# OpenTAXII
Installs [OpenTAXII](https://github.com/EclecticIQ/OpenTAXII) as a deamon that can be launched via a SysV service script. The complementary client implementation, [Cabby](https://github.com/EclecticIQ/cabby) is also installed.
diff --git a/metron-deployment/roles/pcap_replay/README.md b/metron-deployment/roles/pcap_replay/README.md
index 8bc92c9687..01475f9fcc 100644
--- a/metron-deployment/roles/pcap_replay/README.md
+++ b/metron-deployment/roles/pcap_replay/README.md
@@ -1,3 +1,20 @@
+
Pcap Replay
===========
diff --git a/metron-deployment/roles/sensor-stubs/README.md b/metron-deployment/roles/sensor-stubs/README.md
index 5acd36eb65..3e99cfc26e 100644
--- a/metron-deployment/roles/sensor-stubs/README.md
+++ b/metron-deployment/roles/sensor-stubs/README.md
@@ -1,4 +1,20 @@
-
+
# Sensor Stubs
A service has been created to simulate the behavior of a sensor by sending canned telemetry data to a Kafka topic. These "Sensor Stubs" consume fewer resources than the actual sensor that they replace.
diff --git a/metron-deployment/roles/sensor-test-mode/README.md b/metron-deployment/roles/sensor-test-mode/README.md
index 76a3220541..37afad82d4 100644
--- a/metron-deployment/roles/sensor-test-mode/README.md
+++ b/metron-deployment/roles/sensor-test-mode/README.md
@@ -1,3 +1,20 @@
+
Sensor Test Mode
================
diff --git a/metron-deployment/vagrant/README.md b/metron-deployment/vagrant/README.md
index 9e48302412..6a86b6abc0 100644
--- a/metron-deployment/vagrant/README.md
+++ b/metron-deployment/vagrant/README.md
@@ -1,3 +1,20 @@
+
# Vagrant Deployment
- Fast CAPA Test Platform
diff --git a/metron-deployment/vagrant/fastcapa-test-platform/README.md b/metron-deployment/vagrant/fastcapa-test-platform/README.md
index 95c3cdf4dc..213d1150f4 100644
--- a/metron-deployment/vagrant/fastcapa-test-platform/README.md
+++ b/metron-deployment/vagrant/fastcapa-test-platform/README.md
@@ -1,3 +1,20 @@
+
Fastcapa Test Environment
=========================
diff --git a/metron-deployment/vagrant/full-dev-platform/README.md b/metron-deployment/vagrant/full-dev-platform/README.md
index b6624ac8e0..3da383c518 100644
--- a/metron-deployment/vagrant/full-dev-platform/README.md
+++ b/metron-deployment/vagrant/full-dev-platform/README.md
@@ -1,3 +1,20 @@
+
Full Development Platform
=========================
diff --git a/metron-interface/metron-alerts/README.md b/metron-interface/metron-alerts/README.md
index 8480a6904b..0cc2fbae97 100644
--- a/metron-interface/metron-alerts/README.md
+++ b/metron-interface/metron-alerts/README.md
@@ -1,3 +1,20 @@
+
- [Caveats](#caveats)
- [Prerequisites](#prerequisites)
- [Development Setup](#development-setup)
diff --git a/metron-interface/metron-config/README.md b/metron-interface/metron-config/README.md
index 1b20731567..7ae774b17c 100644
--- a/metron-interface/metron-config/README.md
+++ b/metron-interface/metron-config/README.md
@@ -1,3 +1,20 @@
+
# Metron Management UI
This module provides a user interface for management functions in Metron.
diff --git a/metron-interface/metron-rest/README.md b/metron-interface/metron-rest/README.md
index 0cf58c0495..c9684a5e02 100644
--- a/metron-interface/metron-rest/README.md
+++ b/metron-interface/metron-rest/README.md
@@ -1,3 +1,20 @@
+
# Metron REST
This module provides a RESTful API for interacting with Metron.
diff --git a/metron-platform/Performance-tuning-guide.md b/metron-platform/Performance-tuning-guide.md
index a1fe738177..8a2a1ba6b1 100644
--- a/metron-platform/Performance-tuning-guide.md
+++ b/metron-platform/Performance-tuning-guide.md
@@ -1,3 +1,20 @@
+
# Metron Performance Tuning Guide
## Overview
diff --git a/metron-platform/metron-api/README.md b/metron-platform/metron-api/README.md
index 7b4aa4e98d..4a0dde8298 100644
--- a/metron-platform/metron-api/README.md
+++ b/metron-platform/metron-api/README.md
@@ -1,3 +1,20 @@
+
# Metron PCAP Service
The purpose of the Metron PCAP service is to provide a middle tier to
diff --git a/metron-platform/metron-common/README.md b/metron-platform/metron-common/README.md
index 5f9fec6015..ab90a66b5f 100644
--- a/metron-platform/metron-common/README.md
+++ b/metron-platform/metron-common/README.md
@@ -1,5 +1,20 @@
-
-
+
# Contents
* [Stellar Language](#stellar-language)
diff --git a/metron-platform/metron-data-management/README.md b/metron-platform/metron-data-management/README.md
index c351f48e29..b6acd830ec 100644
--- a/metron-platform/metron-data-management/README.md
+++ b/metron-platform/metron-data-management/README.md
@@ -1,3 +1,20 @@
+
# Resource Data Management
This project is a collection of classes to assist with loading of
diff --git a/metron-platform/metron-elasticsearch/README.md b/metron-platform/metron-elasticsearch/README.md
index 9113672cc6..7278a25b33 100644
--- a/metron-platform/metron-elasticsearch/README.md
+++ b/metron-platform/metron-elasticsearch/README.md
@@ -1,3 +1,20 @@
+
# Elasticsearch in Metron
## Introduction
diff --git a/metron-platform/metron-enrichment/README.md b/metron-platform/metron-enrichment/README.md
index 70bf832208..d742046ad1 100644
--- a/metron-platform/metron-enrichment/README.md
+++ b/metron-platform/metron-enrichment/README.md
@@ -1,3 +1,20 @@
+
# Enrichment
## Introduction
diff --git a/metron-platform/metron-indexing/README.md b/metron-platform/metron-indexing/README.md
index d8c5beb008..e7f1e4fa0a 100644
--- a/metron-platform/metron-indexing/README.md
+++ b/metron-platform/metron-indexing/README.md
@@ -1,3 +1,20 @@
+
# Indexing
## Introduction
diff --git a/metron-platform/metron-management/README.md b/metron-platform/metron-management/README.md
index 07a5b1a185..c4b9555ac1 100644
--- a/metron-platform/metron-management/README.md
+++ b/metron-platform/metron-management/README.md
@@ -1,3 +1,20 @@
+
# Stellar REPL Management Utilities
In order to augment the functionality of the Stellar REPL, a few
diff --git a/metron-platform/metron-parsers/README.md b/metron-platform/metron-parsers/README.md
index 88dde44416..ade0f51fed 100644
--- a/metron-platform/metron-parsers/README.md
+++ b/metron-platform/metron-parsers/README.md
@@ -1,3 +1,20 @@
+
# Parsers
## Introduction
diff --git a/metron-platform/metron-parsers/parser-testing.md b/metron-platform/metron-parsers/parser-testing.md
index e30a7b703e..3d670b5782 100644
--- a/metron-platform/metron-parsers/parser-testing.md
+++ b/metron-platform/metron-parsers/parser-testing.md
@@ -1,3 +1,20 @@
+
# Parser Contribution and Testing
So you want to contribute a parser to Apache Metron. First off, on behalf
diff --git a/metron-platform/metron-pcap-backend/README.md b/metron-platform/metron-pcap-backend/README.md
index 69ffe52fe4..e7960e3c03 100644
--- a/metron-platform/metron-pcap-backend/README.md
+++ b/metron-platform/metron-pcap-backend/README.md
@@ -1,3 +1,20 @@
+
# Metron PCAP Backend
The purpose of the Metron PCAP backend is to create a storm topology
diff --git a/metron-sensors/README.md b/metron-sensors/README.md
index ad30c82fa1..d926d97975 100644
--- a/metron-sensors/README.md
+++ b/metron-sensors/README.md
@@ -1,3 +1,20 @@
+
Metron Sensors
--------------
diff --git a/metron-sensors/fastcapa/README.md b/metron-sensors/fastcapa/README.md
index 37c4189944..277f51854f 100644
--- a/metron-sensors/fastcapa/README.md
+++ b/metron-sensors/fastcapa/README.md
@@ -1,3 +1,20 @@
+
Fastcapa
========
diff --git a/metron-sensors/pycapa/README.md b/metron-sensors/pycapa/README.md
index ed929f9171..ab4389f222 100644
--- a/metron-sensors/pycapa/README.md
+++ b/metron-sensors/pycapa/README.md
@@ -1,3 +1,20 @@
+
Pycapa
------
diff --git a/metron-stellar/stellar-3rd-party-example/README.md b/metron-stellar/stellar-3rd-party-example/README.md
index 14c489e621..e2f2c1bd91 100644
--- a/metron-stellar/stellar-3rd-party-example/README.md
+++ b/metron-stellar/stellar-3rd-party-example/README.md
@@ -1,3 +1,20 @@
+
# Introduction
This is just a sample 3rd party stellar function (which is used in our
diff --git a/metron-stellar/stellar-common/3rdPartyStellar.md b/metron-stellar/stellar-common/3rdPartyStellar.md
index 3a6f95861d..ff54234f5f 100644
--- a/metron-stellar/stellar-common/3rdPartyStellar.md
+++ b/metron-stellar/stellar-common/3rdPartyStellar.md
@@ -1,3 +1,20 @@
+
# Custom Stellar Functions
Metron is fundamentally a programmable, extensible system
diff --git a/metron-stellar/stellar-common/README.md b/metron-stellar/stellar-common/README.md
index 09bd4d60dc..6c420b6ef8 100644
--- a/metron-stellar/stellar-common/README.md
+++ b/metron-stellar/stellar-common/README.md
@@ -1,4 +1,20 @@
-
+
# Stellar Language
For a variety of components (threat intelligence triage and field transformations) we have the need to do simple computation and transformation using the data from messages as variables. For those purposes, there exists a simple, scaled down DSL created to do simple computation and transformation.
diff --git a/pom.xml b/pom.xml
index 37c7ccbec1..3e5239297c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -304,7 +304,6 @@
dependencies_with_url.csv
apache-maven-3.3.9/**
- **/*.md
**/VERSION
**/*.json
**/*.json.j2
diff --git a/site-book/README.md b/site-book/README.md
index 52aae51417..25e1a3977c 100644
--- a/site-book/README.md
+++ b/site-book/README.md
@@ -1,3 +1,20 @@
+
# Metron Site-Book documentation
Metron's Site Book is an attempt at producing documentation that is:
diff --git a/use-cases/README.md b/use-cases/README.md
index 02be32d04c..710578599b 100644
--- a/use-cases/README.md
+++ b/use-cases/README.md
@@ -1,3 +1,20 @@
+
# Worked Examples
The following are worked examples of use-cases that showcase some (or
diff --git a/use-cases/forensic_clustering/README.md b/use-cases/forensic_clustering/README.md
index 7aa34687ee..f9c1333674 100644
--- a/use-cases/forensic_clustering/README.md
+++ b/use-cases/forensic_clustering/README.md
@@ -1,3 +1,20 @@
+
# Problem Statement
Having a forensic hash, such as [TLSH](https://github.com/trendmicro/tlsh), is a useful tool in cybersecurity.
diff --git a/use-cases/geographic_login_outliers/README.md b/use-cases/geographic_login_outliers/README.md
index bfa5234073..1e092a10d3 100644
--- a/use-cases/geographic_login_outliers/README.md
+++ b/use-cases/geographic_login_outliers/README.md
@@ -1,3 +1,20 @@
+
# Problem Statement
One way to find anomalous behavior in a network is by inspecting user