in reply to Standardising code documentation

You may check POD Standards, which contains an extensive discussion and many interesting ideas...