Best practice per la clonazione e il commit del repository "Wiki" per un progetto BitBucket

Question

In BitBucket, puoi creare un Wiki per un progetto. Tuttavia, il wiki stesso è un repository separato dal repository di origine. Quando lo cloni, crea un repo con il nome "wiki".

Dove è il luogo ideale o convenzionale per clonare questo repository? Lo metti nel repository di origine? In tal caso, si .gitignore/wiki quando si esegue il commit dal repository di origine? O includi il repository wiki nel repository di origine?

Quando si preme, si commette due volte, una volta nel repository sorgente e poi di nuovo nel repository wiki? O puoi modificare il git della sorgente per commettere sia la fonte che il wiki?

Grazie.

Answer 1

Mantengo la seguente struttura per i repository.

L'idea è di mantenere il codice di pronti contro termine ed è legata wiki come fratelli. In questo modo non è necessario dire a .gitignore di ignorare qualsiasi file relativo al wiki. Inoltre, si preme solo sul repository in cui si stanno apportando modifiche. Spero, questo è quello che stavi cercando.

Answer 2

Il modo ideale sta usando la funzione modulo di Git:

$ cd project 
$ git submodule add https://bitbucket.org/user/project.git/wiki 

Questo crea un file di cartelle wiki e .gitmodules, quindi:

$ cd wiki 
$ nano Home.md 

cambiare qualcosa di informazioni nel file, e:

$ git add . 
$ git commit -m "Some comment" 
$ git push origin master 

Ritorno al progetto:

$ cd .. 
$ git add . 
$ git commit -m "Added wiki module" 
$ git push [remoteName] [remoteBranch] 

Con questo il repository del progetto genererà un collegamento a un commit specifico del repository wiki, è possibile aggiornarne entrambi uno solo.

Spero che questo sia utile.

Maggiori informazioni: https://git-scm.com/book/en/v2/Git-Tools-Submodules