Um repositório também deve servir como site do projeto (pelo menos para pequenos projetos)?

Aug 17 2020

Esta é uma questão mais filosófica, mas tais questões são permitidas aqui.

Como todos sabemos, existem vários hosts de projetos gratuitos. O recurso comum para provavelmente todos eles é a capacidade de vincular ou até mesmo gerenciar um site externo.

Minha pergunta é: você acha que há realmente necessidade de um site externo?

Um lugar como o GitHub permite que os proprietários do projeto criem um wiki com capturas de tela etc. No entanto, lugares como a caixa de informações do software da Wikipedia tratam o GitHub como um repositório enquanto esperam que o link oficial leve a outro lugar.

Por quê? Talvez grandes projetos não queiram depender de terceiros como o GitHub, mas e os pequenos projetos?

Por que ter 2 sites idênticos, ambos com exatamente as mesmas informações, manual, etc. (exceto que um deles é chamado de repositório)?

O que deveria ser melhor para o marketing?

E se você escolher um site externo, não deve usar o wiki do repositório para evitar a duplicação mencionada?

Respostas

5 amon Aug 17 2020 at 01:58

Para muitos projetos, um README é tudo o que é necessário em termos de site. Como os hosts do repositório, como o GitHub ou o Gitlab, exibirão esse README bem renderizado, um site não acrescentaria muito. Esta é uma abordagem comum para provavelmente a grande maioria dos softwares open-ish.

Um site separado (possivelmente em seu próprio domínio) faz mais sentido quando você deseja que o projeto tenha uma identidade menos dependente do serviço de hospedagem de origem ou se deseja mostrar conteúdo que vai além do que pode ser razoavelmente colocado em um README . Então, essencialmente, marketing ou documentos. Mesmo que o código-fonte do site faça parte do repositório de código-fonte, eles não são os mesmos. Mesmo no formato renderizado, esses arquivos de origem não são muito amigáveis, por exemplo, os links podem estar errados ou o GitHub pode não entender completamente a sintaxe.

No entanto, sugiro que você fique longe do recurso Wiki do GitHub. No lado positivo, as páginas wiki são fáceis de editar. Mas, em comparação com um site real, eles são difíceis de encontrar e são muito limitados em opções de navegação ou temas. A maioria dos bons usos dos wikis do GH parece ser como uma base de conhecimento do projeto ou como uma espécie de bloco de notas. Este wiki nunca servirá como uma página inicial para os usuários, então você precisa vincular o wiki de outro lugar (README e/ou website).