¿Qué le resulta más frustrante leer a la gente? ¿Código, documentos científicos o pruebas?

Encuentro que el código suele ser más difícil de leer.

Los artículos científicos, aunque técnicos, están destinados a ser leídos. Es decir, usan oraciones completas, gramática adecuada y tienen un flujo constante (al menos esa es la idea). Incluso con pruebas matemáticas, se presentan en un flujo lógico. Lo que hay que tener en cuenta al leer pruebas y documentos científicos es que leer las palabras por sí solo no es suficiente. Especialmente para las pruebas matemáticas, debe resolver la lógica y convencerse de que realmente comprende lo que se dice.

Por otro lado, he encontrado que el código a menudo está mal documentado, usa nombres de variables no obvios y, por lo general, no tiene un flujo muy lineal a seguir. Incluso con un código bien documentado, queda la organización no lineal. Como resultado, se trata menos de “leer” y más reconstruir partes de un oscuro rompecabezas.