tweaking the flow of docs