¿Debe un repositorio servir también como sitio web del proyecto (al menos para proyectos pequeños)?
Esta es una pregunta más filosófica, pero tales preguntas están permitidas aquí.
Como todos sabemos, hay varios hosts de proyectos gratuitos. La característica común para probablemente todos ellos es la capacidad de vincular o incluso administrar un sitio web externo.
Mi pregunta es: ¿crees que realmente se necesita un sitio web externo?
Un lugar como GitHub permite a los propietarios del proyecto crear un wiki con capturas de pantalla, etc. Sin embargo, lugares como el cuadro de información del software de Wikipedia tratan a GitHub como un repositorio mientras esperan que el enlace oficial lleve a otro lugar.
¿Por qué? Tal vez los proyectos grandes no quieran depender de un tercero como GitHub, pero ¿qué pasa con los proyectos pequeños?
¿Por qué tener 2 sitios web idénticos, ambos con exactamente la misma información, manual, etc. (excepto que uno de ellos se llama repositorio)?
¿Qué debería ser mejor para el marketing?
Y si elige un sitio web externo, ¿no debería usar el wiki del repositorio para evitar la duplicación antes mencionada?
Respuestas
Para muchos proyectos, un README es todo lo que se necesita en términos de un sitio web. Dado que los hosts de repositorios como GitHub o Gitlab mostrarán ese README bien representado, un sitio web no agregaría mucho. Este es un enfoque común para probablemente la gran mayoría del software abierto.
Un sitio web separado (posiblemente en su propio dominio) tiene más sentido cuando desea que el proyecto tenga una identidad que dependa menos del servicio de alojamiento de origen, o si desea mostrar contenido que va más allá de lo que se puede poner razonablemente en un LÉAME. . Entonces, esencialmente, marketing o documentos. Aunque el código fuente del sitio web puede ser parte del repositorio de código fuente, no son lo mismo. Incluso en forma renderizada, esos archivos de origen no son del todo amigables para los humanos, por ejemplo, los enlaces pueden ser incorrectos o GitHub puede no entender completamente la sintaxis.
Sin embargo, le sugiero que se mantenga alejado de la función Wiki de GitHub. En el lado positivo, las páginas wiki son fáciles de editar. Pero en comparación con un sitio web real, son difíciles de encontrar y tienen opciones muy limitadas de navegación o tematización. La mayoría de los buenos usos de los wikis de GH parecen ser como una base de conocimientos de un proyecto o como una especie de bloc de notas. Este wiki nunca servirá como una página de inicio para los usuarios, por lo que debe vincular el wiki desde otro lugar (LÉAME y/o sitio web).