1.4.0 pre
move new/refined logic doc to doc/