updating readme with design decisions