document subroutine placement