Dopo un po 'di tempo in ogni progetto, prima o poi dovrai trovare una funzionalità in esso o correggerlo, quindi mi chiedevo se esiste già un sistema o una convenzione per contrassegnare quelle caratteristiche nel codice ... cosa Voglio dire è in qualche modo segnare un luogo o luoghi nel codice in cui una particolare funzionalità è implementata o testata.
Ci ho pensato e mi è venuta l'idea di creare un nuovo token di commento in Visual Studio come FX e usarlo per contrassegnare particolari funzioni / test con un codice casuale di tre lettere:
class Person
{
public string FirstName
{
set
{
// fx abc
if (string.IsNullOrEmpty(value)) { throw new ArgumentNullException...}
}
}
}
Quindi sono riuscito a tenere traccia di tutte le funzionalità in Excel:
- abc - il nome della persona non deve essere nullo o vuoto / non consente valori vuoti / nulli - hastest: sì
Lo stesso codice a tre lettere che userei anche in un test unitario per testare queste caratteristiche:
(mettendo da parte le convenzioni di denominazione dei test ecc.)
[TestMethod]
[ExpectedException(typeof(ArgumentNullException)]
public void PersonFristNameTest()
{
// fx abc
new Person().FirstName = null;
}
È ovvio che abbiamo una classe Person e ha una proprietà FirstName ... ma non è così facile tenere traccia o documentare ogni singolo requisito o condizione all'interno di ogni proprietà o metodo, specialmente se hai bisogno di trovare qualcosa più tardi o dillo se lo hai già o meno e dove.
Hai visto qualcosa del genere o usi qualcosa di simile da solo? Sono curioso della tua esperienza e dei tuoi suggerimenti.
Non uso ancora questa idea. L'ho inventato un po 'ieri solo dopo aver controllato per la centesima volta se ho già provato un po' di if
s e dove l'ho fatto e se li ho già documentati.