Tuta veloce: leggi questo fantastico articolo su Coding Horror
Ogni volta che sto discutendo il codice al telefono, non l'ho mai letto alla lettera. Devi "compilarlo" in umano, e se c'è ancora confusione all'altra estremità della linea, puoi spostarti verso una lettura più letterale. Ad esempio, avrei letto il tuo esempio come
"Se la barra è vera, incrementa il puntatore baz e assegna il valore a quell'indirizzo su foo. Altrimenti imposta foo su zardoz."
Sono un telelavoratore a tempo pieno dalla metà degli anni '90, quindi praticamente tutte le mie interazioni con i miei colleghi sono state al telefono o altri mezzi indiretti. Molto spesso condividiamo una sessione di schermo (terminale) o VNC (X). Oltre al normale cameratismo, passiamo tutto il giorno a parlare di codice, design, pianificazione, ecc.
Quando parliamo di codice, usiamo un gergo che è profondamente legato al tipo di progetto in fase di elaborazione. Una delle (molte) ragioni per cui un nuovo membro del gruppo impiega così tanto tempo a diventare pienamente funzionale è perché stanno essenzialmente imparando una nuova lingua ogni volta che si uniscono a un nuovo dipartimento / azienda.
Come ho detto sopra, e come altri hanno già detto, proviamo a parlare al livello più alto appropriato per qualsiasi discussione. Ma a volte, devi solo dire a qualcuno: "Digita questo"
Come si dice? Bene, potremmo solo dare un elenco come ...
~ tilde
` backtick
' single quote
" quote (or double quote)
/ slash, \ is backslash
# pound or hash
! bang (or exclamation mark)
@ at
$ dollar
% percent or mod
^ caret or xor
& and or bitwise and
&& and or logical and
| pipe or 'or' or bitwise or
|| 'or'
* value of, times, glob, multiplied by
() parens, open paren, close paren
{} braces, curlies, open stash, close stash
[] brackets, square brackets, at & sub (for subscript) (for C-ish arrays)
...
Questo è il modo in cui "noi" diciamo questi personaggi. Per avere un'idea dell'intera gamma di dire "#" dai un'occhiata alla pagina wiki per #
Quindi c'è troppa variabilità. Deve essere specifico per la lingua in cui stai codificando (proprio come sto scrivendo questo in inglese per la nostra comunicazione umana).
Senza il contesto del linguaggio dovresti costantemente tornare al carattere mediante l'ortografia dei personaggi. Quindi la maggior parte delle persone che conosco ricorrono a qualunque cosa lo standard linguistico chiami cose.
SELECT COUNT(*) INTO x FROM ... (SQL)
X IS Y + 1 (Prolog)
(setq x 40) (Emacs lisp)
/def x 40 (PostScript)
x = 40 (C)
$x = 40 (Perl)
Ognuno di questi sarebbe implicito semplicemente dicendo "Imposta X su ..." nel contesto appropriato. Non farmi nemmeno iniziare su quale codice viene letto come "la stringa X è uguale alla stringa Y".
Se dici "hash bang bin bash" o "shebang bash", quasi tutti sapranno che significa "#! / Bin / bash". In caso contrario, diranno "Eh?", E lo abbasserai di un gradino "Nella parte superiore del file: cancelletto, punto esclamativo, barra, cestino, barra, bash, newline". Se ancora non lo capiscono, lo abbassi ancora una volta: "Vedi quella tastiera di fronte a te? Vedi il tasto" 3 "? Quel segno in alto quando premi maiusc è un cancelletto, quello."
Linea di fondo:
- non ti preoccupare troppo, ti sbaglierai, tutti lo supereranno
- è troppo specifico per quello che fai
- porta sempre un asciugamano
- leggi l'articolo su Coding Horror