ported all info in design spec into README