public_member_api_docs

Document all public members.

This rule is available as of Dart 2.0.0.

Details

DO document all public members.

All non-overriding public members should be documented with /// doc-style comments.

BAD:

class Bad {
  void meh() { }
}

GOOD:

/// A good thing.
abstract class Good {
  /// Start doing your thing.
  void start() => _start();

  _start();
}

In case a public member overrides a member it is up to the declaring member to provide documentation. For example, in the following, Sub needn’t document init (though it certainly may, if there’s need).

GOOD:

/// Base of all things.
abstract class Base {
  /// Initialize the base.
  void init();
}

/// A sub base.
class Sub extends Base {
  @override
  void init() { ... }
}

Note that consistent with dart doc, an exception to the rule is made when documented getters have corresponding undocumented setters. In this case the setters inherit the docs from the getters.

Usage

To enable the public_member_api_docs rule, add public_member_api_docs under linter > rules in your analysis_options.yaml file:

linter:
  rules:
    - public_member_api_docs