convert README to Markdown and warn about averaging bug