Split the README documentation into better section. Refresh the text, so that it matches the current code. Ensure the sample config works with the examples. Closes-bug: 1437703 Change-Id: I1548892a97d82fdcd1a4fe53f24c0fcdb6e35f1f