Estou trabalhando em um mecanismo de jogo RTS de código aberto bastante grande Primaver). Recentemente, adicionei várias funções C ++ que podem ser chamadas por Lua e estou pensando em como documentá-las da melhor maneira e, ao mesmo tempo, também estimulo as pessoas a escrever / atualizar a documentação paramuit de chamadas existentes em Lua.

Então achei que seria bom se eu pudesse escrever a documentação inicialmente como comentários doxygen perto das funções C ++ - isso é fácil porque o corpo da função obviamente define exatamente o que a função faz. No entanto, gostaria que a documentação fosse aprimorada pelos desenvolvedores de jogos que usam o mecanismo, que geralmente têm pouco entendimento do git (o VCS que usamos) ou do C +

or isso, seria ideal se houvesse uma maneira de gerar automaticamente apidocs a partir do arquivo C ++, mas também ter uma interface da web semelhante a wiki para permitir que um público muito mais amplo atualize os comentários, adicione exemplos, et

Então, eu estou me perguntando, existe uma ferramenta da Web que integre a formatação de estilo doxygen, edição semelhante a wiki para esses comentários (de preferência sem permitir a edição de outras partes do arquivo de origem) e o git? (para confirmar os comentários alterados pela interface da web para um ramo especial)

s desenvolvedores do @We poderiam então mesclar este ramo de vez em quando para adicionar os aprimoramentos ao ramo mestre e, ao mesmo tempo, qualquer aprimoramento dos desenvolvedores na documentação terminaria nessa ferramenta da Web com apenas uma mesclagem do ramo mestre. ramo especial.

Ainda não encontrei nada, duvide que algo específico ainda exista, então qualquer sugestão é bem-vinda!