Poderia explicar os princípios de criação de um código legível e fácil de manter?

Código legível e sustentável é aquele que outros desenvolvedores (ou você mesmo após algum tempo) podem entender e modificar facilmente. Princípios principais:

• Nomes claros: variáveis, funções e classes devem ter nomes que reflitam seu propósito.
• Divisão em funções e módulos: cada função deve realizar uma tarefa, os módulos devem ser responsáveis por partes específicas da lógica.
• Estilo de codificação consistente: seguir um estilo uniforme de formatação, indentação e convenções.
• Comentários relevantes: escrever comentários onde a lógica não seja óbvia, mas sem exageros.
• Evitar duplicação de código: usar funções e classes reutilizáveis.
• Tratamento de erros: prever e tratar corretamente possíveis erros.

Exemplo em Swift:

func fetchUserData(userId: String) -> User? {
    // Obtemos os dados do usuário pelo ID
    guard let data = database.getUserData(id: userId) else {
        return nil
    }
    return User(data: data)
}

Aqui, a função tem um nome claro, realiza uma tarefa e possui um comentário para esclarecimento.