front end documentation, refactoring and a template placeholder for inline interpretations