Estilo y Formato como Comunicación

Piensa en un archivo fuente bien estructurado como en un artículo de periódico. En la parte superior encuentras el titular y los puntos clave: API pública, funciones exportadas. A medida que bajas, el detalle aumenta: helpers privados, implementación. Un lector debe entender el propósito del módulo en las primeras 20 líneas, sin necesidad de profundizar en la implementación.

function _validateEmailFormat(email):
    return "@" in email

function _hashPassword(password):
    return hash(password)

function registerUser(name, email, password):  // ← hard to find
    ...

function registerUser(name, email, password):
    if not _isValidEmail(email):
        raise ValueError("Invalid email")
    return {
        name: name,
        password: _hashPassword(password),
    }

// ── Private helpers ──────────
function _isValidEmail(email): ...
function _hashPassword(password): ...

Las líneas en blanco son los saltos de párrafo del código. Úsalas para separar conceptos: imports de la declaración de clase, métodos entre sí. No añadas líneas en blanco dentro de una lógica que pertenece junta — el código denso señala acoplamiento estrecho.

import FileSystem
import Platform
class UserService:
    db=null
    function find(id):
        return db.query(id)
    function save(user):
        db.insert(user)

import FileSystem
import Platform

class UserService:
    db = null

    function find(userId):
        return db.query(userId)

    function save(user):
        db.insert(user)

Mantén las líneas por debajo de los 120 caracteres — las líneas largas obligan al scroll horizontal y ocultan la estructura. La indentación es el contrato visual que indica a los lectores qué código pertenece a dónde. Nunca luches contra el formateador acordado por tu equipo (black, prettier, eslint). El estilo personal es irrelevante en un entorno de equipo.

function calculateOrderTotal(order, user, discountService, taxService, currencyConverter, targetCurrency):
    return currencyConverter.convert(taxService.apply(discountService.apply(order.subtotal, user.tier), order.region), targetCurrency)

function calculateOrderTotal(
    order, user,
    discountService, taxService,
    currencyConverter,
    targetCurrency,
):
    subtotal = discountService.apply(
        order.subtotal, user.tier)
    withTax = taxService.apply(
        subtotal, order.region)
    return currencyConverter.convert(
        withTax, targetCurrency)

Formatea Este Desorden — aplica la metáfora del periódico, añade líneas en blanco y rompe la línea larga.