design/d1: Incorporate Darren's suggestions
design/d1: Format README in markdown