Remove cc license from default footer-text

[damien-git]

Pages generated by dartdoc have the following footer (which is not changed with the --footer option): the name of the application, the Dart icon, and "cc license". My application is not distributed under the cc license, but this makes it look like it is. Is there any way to change that ?

[devoncarew]

No feature for that currently, but you can post-process the generated docs.

I believe that cc license isn't meant to apply to the package, but to the generated docs.

[damien-git]

Then maybe dartdoc could write "Dart" or "generated by dartdoc" instead of the package name before the license.

[sethladd]

Good idea. Patches welcome!

[kevmoo]

@devoncarew @jcollins-g We should change the default here. We shouldn't guess the license.

We could add a field to the pubspec that contains dartdoc-specific info, like the doc license.

[jcollins-g]

I think licensing information probably does belong in pubspec.yaml because it isn't dartdoc specific. I don't want dartdoc-specific options in pubspec.yaml; instead, I'm planning a dartdoc_options.yaml similar to analysis_options.yaml.

[kevmoo]

Sure. I guess if a package author wants tweak things there they can.

The "default" should be nothing – again, we shouldn't be guessing for the user.

[jcollins-g]

A simple change to dartdoc + a change to the SDK when upgrading the version is required here.

[kevmoo]

Glad it's simple 😄

[kwalrath]

dartdoc_options.yaml sounds great. What do you think would be there?

[jcollins-g]

@kwalrath I want to place there most options that are currently command line flags, such as header/footer, whether to group categories, etc. Additionally, similar to analyzer, I want a section for controlling dartdoc warnings and which to treat as errors or warnings. The code is actually almost ready for that breakout but we need somewhere nice to land the configuration options rather than just greatly expanding our command line flags:

dartdoc/lib/src/model.dart

Line 3307 in fb2c2d0

Map<PackageWarning, PackageWarningHelpText> packageWarningText = {