// ❌ Codice legacy privo di controllo dei tipi e di TSDoc
function processUserData(data: any) {
  console.log("User ID:", data.id);
  if (data.role === "admin") {
    return data.permissions.includes("write");
  }
  return false;
}

Refactoring del Tipo any in TypeScript con Type Guard e TSDoc

// PRIMA : Codice legacy verboso e incline a errori
public abstract class Response {
}

public class SuccessResponse extends Response {
    private final String data;
    public SuccessResponse(String data) { this.data = data; }
    public String getData() { return data; }
}

public class ErrorResponse extends Response {
    private final String errorCode;
    public ErrorResponse(String errorCode) { this.errorCode = errorCode; }
    public String getErrorCode() { return errorCode; }
}

public class ResponseProcessor {
    public static String process(Response response) {
        if (response instanceof SuccessResponse) {
            SuccessResponse success = (SuccessResponse) response;
            return "OK: " + success.getData();
        } else if (response instanceof ErrorResponse) {
            ErrorResponse error = (ErrorResponse) response;
            return "FAIL: " + error.getErrorCode();
        } else {
            throw new IllegalArgumentException("Unknown response type");
        }
    }
}

Refactoring in Java 21+: Records e Pattern Matching per Codice Leggibile

namespace JWDocs.Services;

/// <summary>
/// Servizio responsabile dell'elaborazione dei pagamenti.
/// </summary>
public class PaymentProcessor
{
    private readonly IPaymentGateway _gateway;
    private readonly ILogger _logger;

    /// <summary>
    /// Inizializza una nuova istanza di <see cref="PaymentProcessor"/>.
    /// </summary>
    /// <param name="gateway">Il provider di pagamento principale.</param>
    /// <param name="logger">Il servizio di registrazione di audit.</param>
    public PaymentProcessor(IPaymentGateway gateway, ILogger logger)
    {
        _gateway = gateway ?? throw new ArgumentNullException(nameof(gateway));
        _logger = logger ?? throw new ArgumentNullException(nameof(logger));
    }

    public async Task ProcessAsync(decimal amount)
    {
        _logger.LogInfo("Avvio pagamento...");
        await _gateway.ChargeAsync(amount);
    }
}

C# 12 Moderno: Refactoring con Primary Constructors e XML Docs

const config = {
  retries: 3,
  endpoint: "https://api.example.com",
} satisfies Record<string, string | number>;

const timeout = options?.timeout ?? 5000;
const city = user?.address?.city ?? "Sin ciudad";

TypeScript moderno: ?., ?? e satisfies senza errori di formattazione

SELECT o.id, o.total, c.name
FROM orders AS o
JOIN customers AS c ON c.id = o.customer_id
WHERE o.created_at >= DATE '2026-01-01'
ORDER BY o.total DESC;

SQL e DAX: tre abitudini per query veloci e leggibili

match command.split():
    case ["go", direction] if direction in {"north", "south"}:
        move(direction)
    case ["quit" | "exit"]:
        shutdown()
    case _:
        print("Comando desconocido")

PEP 8 in Python 3.12: scrivere blocchi match/case leggibili