Would recommend splitting out the documentation bits into a separate plug-in so that they are more easily accessed by the documentation team. Easier for them to tweak a doc plug-in separate from the rest of the code to avoid any accidental code changes.