Overol rápido: lea este excelente artículo en Coding Horror
Cada vez que estoy discutiendo el código por teléfono, nunca lo leo literalmente. Tienes que "compilarlo" para humanos, y si todavía hay confusión en el otro extremo de la línea, puedes avanzar hacia una lectura más literal. Por ejemplo, leería tu ejemplo como
"Si la barra es verdadera, incremente el puntero baz y asigne el valor en esa dirección a foo. De lo contrario, configure foo en zardoz".
He trabajado a tiempo completo desde mediados de los 90, por lo que prácticamente todas mis interacciones con mis colegas han sido por teléfono u otros medios indirectos. Muy a menudo compartimos una sesión de pantalla (terminal) o VNC (X). Además de la camaradería habitual, pasamos todo el día hablando de código, diseño, planificación, etc.
Cuando hablamos de código, usamos jerga que está profundamente vinculada al tipo de proyecto que se está trabajando. Una de las (muchas) razones por las que un nuevo miembro del grupo tarda tanto en ser completamente funcional es porque esencialmente están aprendiendo un nuevo idioma cada vez que se unen a un nuevo departamento / empresa.
Como dije anteriormente, y como han dicho otros, tratamos de hablar al nivel más alto que sea apropiado para cualquier discusión. Pero a veces, realmente tienes que decirle a alguien: "Escribe esto"
¿Como lo dices? Bueno, podríamos dar una enumeración como ...
~ 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)
...
Así es como "nosotros" decimos estos personajes. Para tener una idea del rango completo de decir "#", mire la página wiki para #
Entonces hay demasiada variabilidad. Tiene que ser específico para el idioma en el que está codificando (al igual que estoy escribiendo esto en inglés para nuestra comunicación humana).
Sin el contexto del lenguaje, tendrías que volver constantemente al carácter por la ortografía de los caracteres. Así que la mayoría de las personas que conozco recurren a lo que el estándar de lenguaje llama cosas.
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)
Cada uno de ellos estaría implícito simplemente diciendo "Establecer X para ..." dentro del contexto apropiado. Ni siquiera me hagas comenzar con el código que se lee como "es la cadena X igual a la cadena Y".
Si dice "hash bang bin bash" o "shebang bash", casi todos sabrán que significa "#! / Bin / bash". Si no lo hacen, dirán "¿Eh?", Y lo bajarán un escalón "En la parte superior del archivo: signo de libra, signo de exclamación, barra oblicua, bin, barra oblicua, bash, nueva línea". Si todavía no lo entienden, lo baja una vez más: "¿Ve ese teclado frente a usted? ¿Ve la tecla" 3 "? Esa marca en la parte superior cuando presiona shift es un signo de libra, eso".
Línea de fondo:
- no te preocupes demasiado, te equivocarás, todos lo superarán
- es demasiado específico para exactamente lo que haces
- siempre lleve una toalla
- lea el artículo en Coding Horror