Recensioni del codice TFS: mostra i file aggiornati in risposta ai commenti


127

Stiamo iniziando a utilizzare la funzionalità di revisione del codice integrata nell'anteprima di VS 2012 e VS 2013. Richiedere la recensione e aggiungere commenti sembra abbastanza semplice. Se qualcuno aggiunge commenti che richiedono la modifica del codice, in che modo il richiedente apporta queste modifiche e le mostra?

Quindi il processo scorre in questo modo:

  1. La persona 1 richiede una revisione del codice.
  2. La persona 2 aggiunge commenti e seleziona "Ha bisogno di lavoro".
  3. La persona 1 apporta le modifiche necessarie.

In che modo la persona 1 ora mostra queste modifiche alla persona 2? Puoi aggiungere commenti e inviarli, ma i file non cambiano. Suppongo che i file provengano dal changeset creato quando è stata richiesta la revisione originale. La persona 1 dovrebbe chiudere questa recensione e richiedere una seconda recensione?

La creazione di una seconda recensione non sembra ottimale, perché perdi la cronologia della tua conversazione sul perché stavi apportando le modifiche.

Ci sono tonnellate di siti Web che mostrano come utilizzare le funzionalità di base delle recensioni del codice, ma ci sono siti che mostrano le migliori pratiche? Ad esempio, chi dovrebbe fare clic sulle caselle di controllo accanto ai file?


+1 per "ci sono siti che mostrano le migliori pratiche". Gli ALM Ranger sono di solito i miei "goto guy" per un uso approfondito, ma le uniche informazioni che riesco a trovare non rispondono alla tua domanda. Mi piacerebbe vedere alcuni walkthough e scenari per l'utilizzo di Code Review.
DaveShaw,

Risposte:


164

Quindi il processo scorre in questo modo:

  1. La persona 1 richiede una revisione del codice.
  2. La persona 2 aggiunge commenti e seleziona "Ha bisogno di lavoro".
  3. La persona 1 apporta le modifiche necessarie.
  4. Persona 1 Aggiorna lo shelfet associato alla revisione del codice
  5. La persona 1 aggiunge commenti per continuare la discussione
  6. Ripetere i passaggi da 2 a 5 fino a quando non viene accettato

Ecco i passaggi necessari per aggiornare lo scaffale associato alla recensione.

  1. Dal riquadro "Revisione codice" selezionare il collegamento "Visualizza scaffale"
  2. Dal riquadro "Dettagli scaffale" evidenziare e copiare il nome dello scaffale
  3. Passa al riquadro "Modifiche in sospeso", fai clic su "Shelve" e incolla il nome dello scaffale
  4. Premi il pulsante Sì sulla finestra di dialogo di verifica della sostituzione dello scaffale
  5. Ora il revisore può vedere i file aggiornati e la discussione sulla revisione può continuare

Ho incluso alcune schermate poiché trovo che aiuti a chiarire le cose.


1) Dal riquadro "Revisione codice" selezionare il collegamento "Visualizza scaffale" come mostrato qui:

inserisci qui la descrizione dell'immagine


2) Dal riquadro "Dettagli scaffale" evidenziare e copiare il nome dello scaffale come mostrato qui:

inserisci qui la descrizione dell'immagine


3) Passa al riquadro "In attesa di modifiche", fai clic su "Shelve" e incolla il nome dello scaffale, ad esempio:

inserisci qui la descrizione dell'immagine


4) Premere il pulsante Sì sulla finestra di dialogo di verifica della sostituzione dello scaffale:

inserisci qui la descrizione dell'immagine


7
Il problema con questa soluzione è che è distruttivo in quanto tutti i commenti vengono spazzati via. Penso che una soluzione migliore sarebbe quella di creare una nuova revisione del codice e impostare quella precedente come elemento correlato.
Bardia,

15
La sostituzione dello shelfet non tocca i commenti solo i file. Il nostro team utilizza questo metodo con successo e non perdiamo alcun commento di recensione.
Chad Dienhart,

10
Funziona, ma se aggiungi / rimuovi righe quando modifichi un file e sostituisci lo scaffale, i commenti che si trovavano su quel file rimandano a righe sbagliate.
Mento

2
Di solito non mi piace ripetere, ma il punto sopra di Chin rende questa risposta completamente insostenibile. Sì, puoi facilmente aggiornare il tuo scaffale, ma in questo modo essenzialmente TUTTI i commenti delle recensioni precedenti ora puntano a un testo ERRATO. (Perché a quanto pare un commento di recensione è allegato a un offset assoluto dall'inizio di un file.)
Michael Sorens

7
Troppo manuale e non l'ideale. TFS o Visual Studio dovrebbero avere qualcosa per confrontare le modifiche tra revisioni consecutive, in modo che il revisore possa vedere esattamente le modifiche apportate dall'ultima revisione. Non esiste niente del genere? Forse un plugin o qualcosa del genere ...
Iúri dos Anjos

6

Credo che la procedura corretta sia la persona 1 per apportare le modifiche e richiedere un'altra revisione. Quando il tuo codice ha bisogno di lavoro, significa che lo cambierai, quindi vorrai avere la versione precedente a cui tornare per un confronto. Hai ancora la vecchia recensione nella cronologia dopo che è stata chiusa se desideri esaminare i commenti. Attualmente stiamo ottimizzando il nostro processo di revisione del codice sul mio posto di lavoro.


2

So che questa domanda è vecchia, ma non è ancora supportata come sottolineato da altri poster. La soluzione proposta dal Ciad funzionerà per alcune cose, ma avrà un comportamento strano per altre.

Di recente, il team TFS ha iniziato le fasi di pianificazione per una soluzione a una richiesta di servizi utente molto vecchia per consentire l'aggiornamento di una revisione del codice che dovrebbe risolvere elegantemente questo problema facendo in modo che le revisioni del codice abbiano iterazioni.


1
Grande. Non vedo l'ora di farlo. Gradirei una vera soluzione. Il mio post è semplicemente un modo per aggirare il problema.
Chad Dienhart,

Spero che non sembrino richieste di pull Devure azzurre. Sono un incubo spammy.
StingyJack il

0

Devi farlo con due diverse recensioni. Ma c'è anche un modo per mantenere la storia con la seconda recensione. Tutto ciò che serve sono le attività.

Questo flusso di lavoro è descritto per le recensioni basate su changeset, ma funziona anche per le recensioni basate su shelve.

  1. Crea task1
  2. Prima di effettuare il check in changeset1 aggiungere task1 come elemento di lavoro correlato
  3. Controlla le modifiche con un elemento di lavoro correlato e richiedi la revisione di questo gruppo di modifiche
  4. Crea task2
  5. Prima di effettuare il check in changeset2 aggiungere entrambe le attività come elemento di lavoro correlato.
  6. Controlla le modifiche con due elementi di lavoro correlati e richiedi la revisione di questo gruppo di modifiche

Ora nella seconda richiesta di revisione il revisore è in grado di cercare attività correlate e se il revisore cerca l'attività1, vede il changeset1 e la richiesta di revisione con i suoi commenti. Quindi non perderai la cronologia delle conversazioni.

Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.