Plugins should verify that the dartdocs that will be generated will be up to date. More specifically, it should verify that links aren't broken and references are correct. This could be done with something like:

flutter pub global activate dartdoc
flutter pub global run dartdoc --no-generate-docs --errors='broken-link,unresolved-doc-reference' --verbose-warnings