dartdoc icon indicating copy to clipboard operation
dartdoc copied to clipboard

class name doesn't seem prominent enough on method pages

Open skybrian opened this issue 10 years ago • 3 comments

Consider this page:

https://new-dartdocs-dot-dartlang-api.appspot.com/1.12.0-dev.5.1/dart-async/Stream/first.html

This is a method in the "Stream" class, but the word "Stream" only appears in the sidebar, and isn't very prominent. It's a bit confusing at first, and someone landing here by following a link wouldn't be able to find it easily.

Not sure what the best fix is. Maybe the name of the class should also be listed in the main section, above the method name? Or perhaps the breadcrumb trail should be more prominent?

Stream: Future<T> first read-only

skybrian avatar Aug 07 '15 20:08 skybrian

You bring up a good point.

sethladd avatar Aug 07 '15 20:08 sethladd

Although, actually, the breadcrumb is repeated in the header as well, and I missed in entirely. Not sure what to say. Apparently I've been trained to ignore headers and sidebars and focus on the body.

skybrian avatar Aug 07 '15 20:08 skybrian

Apparently I've been trained to ignore headers and sidebars and focus on the body.

Open to specific ideas. We'll keep this open for now.

sethladd avatar Aug 07 '15 20:08 sethladd