For package docs: show the path to the documented library

[kevmoo]

For instance, shelf.io is at package:shelf/shelf_io.dart, etc

While we'd like for folks to align the the library files and library names, there is no enforcement.

[sethladd]

dart: libraries have the same problem. the library name for dart:io is actually dart_io. Talk about confusing.

[jcollins-g]

So, for each library, show how to import it automatically as part of the library's docs? Or do you want this data on the package page?

[kevmoo]

See
https://webdev.dartlang.org/angular/api/angular2.platform.common/angular2.platform.common-library

I think we should list the library as "platform/common.dart" – which is the URI folks use after "package:angular2"

And here https://webdev.dartlang.org/angular/api/angular2.platform.common/HashLocationStrategy-class

angular2 -> platform/common.dart -> HashLocationStrategy

Seems a better idea.

Sound okay?

[devoncarew]

+1 to de-emphasizing or removing the library name, and instead using the path where the symbol is being defined in or exported from.