more dev docs improvements