updates README; improve documentation
Merge pull request #9 from mediapeers/ticket/13900

updates README; improve documentation