reorg docs and add design sections