How do you organize and maintain code documentation in your projects?

In Flutter projects, I try to document the code using built-in Dartdoc comments. This allows for automatic documentation generation from comments that describe classes, methods, and parameters.

For example:

/// Class representing an application user.
class User {
  /// User's name
  final String name;

  /// Creates a new user with the specified name.
  User(this.name);
}

Additionally, I maintain a README with an architecture overview and main components of the project, and I use tools to generate diagrams and schematics to visualize the application's structure. It's important that the documentation is up-to-date and clear, so I regularly update it along with code changes.