rst replaced with markdown, examples and configuration directives added