Cleanup a few changes noticed during review

+review REVIEW-5222
Updates to play-framework design spec