updated readme based on template and Alan's document

@alanclayton please review