Quais seriam as suas sugestões para um bom modelo de script bash / ksh a ser usado como padrão para todos os scripts recém-criados?

Normalmente começo (após o#! linha) com um cabeçalho comentado com um nome de arquivo, sinopse, uso, valores de retorno, autor (es), registro de alterações e caberia em linhas de 80 caracteres.

Todas as linhas de documentação que inicio com símbolos de hash duplo## para que eu possa cumprimentá-los facilmente e os nomes de var locais são anexados com "__".

Alguma outra prática recomendada? Dicas? Convenções de nomenclatura? E os códigos de retorno?

Comentários sobre controle de versão: usamos o SVN, mas outro departamento da empresa possui um repositório separado e esse é o script deles. Como sei com quem entrar em contato com os perguntas frequentes se não houver informações sobre o autor @? Usar entradas semelhantes ao javadocs tem algum mérito, mesmo no contexto do shell, IMHO, mas posso estar errado.