Estou desenvolvendo uma ferramenta CLI python (usando optparse em python2.6, mas espero mudar em breve para python2.7) e estou prestes a escrever a página de manual. Tenho alguma experiência em gerar páginas de manual dinâmicas por:

criar um método dedicado que compõe uma string empod format e grava-o em um arquivoexecuting the pod2man para gerar dados no formato groff a serem passados para o comando man

Eu também gostaria de gerar páginas wiki com o mesmo conteúdo que a página de manual (com o pod eu posso gerar html através de pod2html e provavelmente o html pode ser facilmente traduzido para o formato wiki). Alguém tem uma idéia / fluxo melhor sobre como fazer isso?

Uma coisa que achei interessante é neste link:riando páginas de manual Usando optparse e distuti