google / dart-shapeshift Goto Github PK

It's too bold. Maybe find another bold, or instead just darken the color.

I completely missed the web part of your package, the browser interface / doc_coverage is a great tool!

From a user:

Does it look at coverage for top-level functions and variables? When I run it on path, I just see the classes it contains.

Looks like:

The from constructor's other parameter's type changed from changed fromdart:core.Mapdart:core.Map.K,dart:core.Map.V todart:core.Mapnull

Right now it looks like:

The value constructor's message parameter's changed from default: true to default: false

There should be a word after "parameter's".

New method code blocks are currently dark grey on slightly less dark grey. I want syntax highlighting.

When we have a new method, in a diff, we show the method signature, with the method's comment up top. The comment is just a dump of the HTML that exists in the JSON. I wish we could deconstruct the HTML back into the Markdown that generated it.

Pretty please?

It would be great if we could reuse some of your comment analyses in the linter.

Right now we have:

The first getter's abstract changed:

Was: true

Now: false

This should instead read like:

The first getter's abstract property changed from true to false.

Or even

The first getter is no longer abstract.

The isEmpty getter is now abstract.

It takes crazy long to load the version lists. Particularly the dev one (291 versions last check.) This takes literally > 20 seconds to load. Maybe we just load the most recent 20 versions or something from each channel, and have a button that loads them all.

From a user:

One little thing I noticed was that it unconditionally complains about short descriptions, e.g., 'An dart:mirrors.InstanceMirror reflects an instance of a Dart language object' for InstanceMirror in dart:mirrors. But that sentence is very precise and possibly quite appropriate in the concrete context. Maybe the checks could look up some kind of LGTM for the wording and only complain about completely missing entries? ;-)

For changes from 1.7.2 to 1.10.1, I had:

class IterableBase

IterableBase has changed subclasses:

• dart:collection.DoubleLinkedQueue is now dart:collection.DoubleLinkedQueue.

This is the same subclasse, or maybe generics are missing?

DiffNode is very bare. A thin wrapper is desirable.

I'd love to have a process in my build that verified my current public API against a baseline. I'm imagining a flow like this:

1. create a baseline
2. cut a release
3. hack on code
4. check changes against baseline and either
   • back out the changes, or
   • update my CHANGELOG and create a new baseline
5. etc...

As a point of reference on baselines, the olde eclipse API tools come to mind.

Maybe this would be a separate tool?

Oops?