Come consiglieresti di creare "ancore" nei commenti di codice, in modo che durante la manutenzione, gli sviluppatori possano facilmente fare riferimenti incrociati ad altri commenti di codice.
Mi rendo conto che il software dovrebbe essere strutturato in modo intelligente e questo dovrebbe mitigare questo requisito in una certa misura, ma mi sono spesso trovato a scrivere un commento in cui vorrei che gli sviluppatori futuri prendessero in considerazione qualcos'altro (non necessariamente una dipendenza diretta).
Ad esempio, "Se cambi questo meccanismo, assicurati di revisionare XYZ". Sto pensando a collegamenti ipertestuali, stile wiki, in cui ogni link ha un identificatore univoco e può avere una relazione uno-a-molti con altri link.
Idealmente, se qualcuno riscrisse parte del mio codice, vorrei che venissero avvisati automaticamente che "qualcos'altro link qui, e dovresti verificarlo nel caso lo stia cambiando" - e io non significa spezzare qualcosa come in "qualcosa non verrà compilato", ma in realtà solo un puntatore (o puntatori) facile da seguire in qualche altra parte di una base di codice che qualcuno (o anche il tuo passato) sentiva che c'era un comprensibile umano collegamento concettuale, concetto o implementazione.
Sarei sorpreso se non ci fosse già uno standard per questo, ma la ricerca di "commenti", "link", "ancora" produce comprensibilmente un proverbiale pagliaio.