dev docs and streamlined tests