doc: further design info.