readme, default and doc updates