uniformity tweaks and documentation