¿Cómo organiza y mantiene la documentación del código en sus proyectos?

En proyectos de Flutter, trato de mantener la documentación del código mediante comentarios integrados de Dartdoc. Esto permite generar automáticamente documentación a partir de los comentarios que describen clases, métodos y parámetros.

Por ejemplo:

/// Clase que representa un usuario de la aplicación.
class User {
  /// Nombre del usuario
  final String name;

  /// Crea un nuevo usuario con el nombre especificado.
  User(this.name);
}

Además, mantengo un README con la descripción de la arquitectura y los componentes principales del proyecto, y utilizo herramientas para generar diagramas y esquemas para visualizar la estructura de la aplicación. Es importante que la documentación esté actualizada y sea comprensible, por lo que la actualizo regularmente junto con los cambios en el código.