request tweaking and documentation cleanup