Como organiza e mantém a documentação do código nos seus projetos?

Nos projetos Flutter, tento manter a documentação do código usando comentários embutidos do Dartdoc. Isso permite gerar automaticamente documentação a partir dos comentários que descrevem classes, métodos e parâmetros.

Por exemplo:

/// Classe que representa um usuário da aplicação.
class User {
  /// Nome do usuário
  final String name;

  /// Cria um novo usuário com o nome especificado.
  User(this.name);
}

Além disso, mantenho um README com a descrição da arquitetura e dos principais componentes do projeto, e uso ferramentas para gerar diagramas e esquemas para visualizar a estrutura do aplicativo. É importante que a documentação esteja atualizada e seja compreensível, por isso a atualizo regularmente junto com as mudanças no código.