Domanda

Ho installato rabbitvcs-core e rabbitvcs-Nautilus su Ubuntu 11.10. Ho l'indirizzo IP del nostro server SVN e non hanno problemi con l'uso TortiseSVN da un PC Windows 7. Come faccio a configurare rabbitvcs di fare una directory di lavoro e di lavoro con il nostro server SVN? Non riesco a trovare nulla nel rabbitvcs FAQ o documenti.

È stato utile?

Soluzione

rabbitvcs è supponiamo di essere come TortoiseSVN su Windows. Cioè, quando si fa clic su una directory, si dovrebbe vedere un menu di contesto e in quel menu di contesto dovrebbe essere comandi di Subversion che ti permettono di fare casse, ecc.

Non ho un sistema Linux con Nautilus installato su di esso, quindi non posso dare i dettagli. Tuttavia, potrebbe essere necessario riavviare Nautilus (modo più semplice è quello di logout e login). Oltre a questo, non posso fare a voi.

E, non ci sono molte informazioni sul sito web del progetto. Il Wiki contiene una FAQ che risponde 9 domande (e nessuna delle risposte sono che dettagliate), e un quattro le istruzioni della riga su come rimuovere rabbitvcs.

Mi scusi mentre salgo sul mio podio qui ...

A tutti voi persone che gestiscono vari progetti open source: un Wiki non è documentazione . Non è semplicemente dire "Hey, andiamo a installare un wiki" e pensare che la documentazione gestirà stessa.

è necessario creare la documentazione PROPRIO

Si, ho gridato che e mettere caplocks su, ma io non so quanti progetti open source che ho visto, senza alcuna documentazione che pensano che un gruppo Google e Wiki bastano. Se si crea un progetto open source:

  • Mettere in ciò che il vostro software fa e una panoramica generale di come funziona.
  • Fatemi sapere ciò che è necessario. Con quali sistemi operativi? Quali altri pacchetti ho bisogno. Voglio sapere prima di scaricarla e tento di installarlo.
  • Dammi una documentazione di installazione completa. Spiegate passo per passo e comprendono linee di comando. Dimmi cosa devo fare o cercare se qualche parte dell'installazione di istruzioni non funziona.
  • Crea un manuale d'uso completa. Non è sufficiente elencare i comandi che può fare. Fatemi sapere come usarlo. Dammi un flusso di lavoro di base, così ho capito come funziona.
  • Se non v'è alcun tipo di attività di amministrazione, ci dovrebbe essere una sorta di manuale di somministrazione con esso. E, fammi sapere su come posso diagnosticare i problemi più comuni.
  • E, più importante di tutti:. Mantenere la documentazione aggiornata
  • Avere una mailing list di supporto e MONITOR di esso. Ho visto un sacco di gruppi attivi con le discussioni in questo modo:

  • Ho avuto questo problema particolare ...

  • Anche a me.
  • Si, ho avuto anch'io.
  • Qualcuno sa come risolvere il problema?
  • No, ma se si trova una risposta, postare qui ...

Questo è meglio di alcuni che sono più simile a questo:

  • Ho avuto questo problema particolare ...
  • Ciao?
  • Qualcuno qui?

Un bell'esempio su come fare le cose per bene in questo senso è il progetto Subversion. Hanno un bellissimo sul manuale di linea (che è disponibile in forma di libro), che passa attraverso come installare Subversion, i flussi di lavoro di base, come usarlo, come amministrarlo, e alcune cose da fare e non fare di base. Il manuale è in continuo aggiornamento.

Se avete una domanda, qualcuno sulla mailing list di solito può rispondere. In caso contrario, un tubo di sviluppatore e rispondere alla domanda.

Una delle ragioni per cui Subversion è diventato così popolare così in fretta era la loro documentazione di supporto e della comunità. Se volete che il vostro progetto open source per avere successo, la documentazione deve essere buona.

Si, lo so che non mi piace scrivere. Tu sei uno sviluppatore e non uno scrittore tecnologia. Tuttavia, la documentazione è altrettanto importante per il vostro progetto come il codice vero e proprio. In effetti, una buona documentazione utente migliora codice perché dà agli sviluppatori un quadro su come funzionano le cose.

Autorizzato sotto: CC-BY-SA insieme a attribuzione
Non affiliato a StackOverflow
scroll top