Un repository dovrebbe fungere anche da sito web del progetto (almeno per i piccoli progetti)?
Questa è una domanda più filosofica, ma tali domande sono consentite qui.
Come tutti sappiamo, ci sono vari host di progetti gratuiti. La caratteristica comune probabilmente a tutti è la possibilità di collegare o persino gestire un sito Web esterno.
La mia domanda è: pensi che ci sia davvero bisogno di un sito web esterno?
Un posto come GitHub consente ai proprietari del progetto di creare un wiki con schermate, ecc. Tuttavia, posti come l'infobox del software di Wikipedia trattano GitHub come un repository mentre si aspettano che il collegamento ufficiale porti da qualche altra parte.
Come mai? Forse i grandi progetti non vogliono fare affidamento su una terza parte come GitHub, ma per quanto riguarda i piccoli progetti?
Perché avere 2 siti Web identici, entrambi con esattamente le stesse informazioni, manuale, ecc. (tranne che uno di essi è chiamato repository)?
Cosa dovrebbe essere migliore per il marketing?
E se scegli un sito web esterno, non dovresti usare il wiki del repository per evitare la suddetta duplicazione?
Risposte
Per molti progetti, un README è tutto ciò che è necessario in termini di un sito web. Poiché host di repository come GitHub o Gitlab visualizzeranno quel README reso bene, un sito Web non aggiungerebbe molto. Questo è un approccio comune probabilmente per la stragrande maggioranza del software open-ish.
Un sito Web separato (possibilmente sul proprio dominio) ha più senso quando si desidera che il progetto abbia un'identità meno dipendente dal servizio di hosting di origine o se si desidera mostrare contenuti che vanno oltre ciò che può essere ragionevolmente inserito in un README . Quindi essenzialmente, marketing o documenti. Anche se il codice sorgente del sito Web potrebbe far parte del repository del codice sorgente, non sono la stessa cosa. Anche in forma renderizzata, quei file sorgente non sono del tutto intuitivi, ad esempio i collegamenti potrebbero essere sbagliati o GitHub potrebbe non comprendere appieno la sintassi.
Tuttavia, ti suggerisco di stare lontano dalla funzione Wiki di GitHub. Tra i lati positivi, le pagine wiki sono facili da modificare. Ma rispetto a un sito Web reale sono difficili da trovare e sono molto limitate nelle opzioni di navigazione o tematica. La maggior parte dei buoni usi dei wiki di GH sembra essere come base di conoscenza di un progetto o come una sorta di blocco appunti. Questo wiki non servirà mai come pagina di destinazione per gli utenti, quindi è necessario collegare il wiki da altrove (README e/o sito web).