rough design documents
a couple of updates