docs done. need showterm and diagram.