update docs a bit; move some to issue tracker