Would be nice if each API documentation page had a mechanism for providing feedback

[jamesderlin]

It would be nice if each API documentation page included a link for providing feedback or corrections for the page, similar to MSDN or for what we do for internal g3doc pages. At a minimum it could be a link that starts a GitHub issue with the URL of the page, like: https://github.com/flutter/flutter/issues/new?title=API%20Documentation%20Feedback&body=Feedback%20for%20http%3A%2F%2Fwww.example.com

(Originally filed as flutter/website#1438 )

[jamesderlin]

I realized that most of the non-API-documentation pages have "File Issue" links (e.g. https://flutter.io/widgets/), so the API documentation pages should do the same for consistency.

[InMatrix]

This feature is currently blocked by dart-lang/dartdoc#1454. Please consider upvoting that issue.

[jamesderlin]

dart-lang/dartdoc#1454 would definitely help, but I don't think it's a strict requirement. As a first step, being able to file a GitHub issues that includes the URL to the documentation page itself would be an improvement. Once dart-lang/dartdoc#1454 is fixed, then the new issue can reference the source file directly.

[InMatrix]

As a first step, being able to file a GitHub issues that includes the URL to the documentation page itself would be an improvement.

Agreed. I wonder if this requires changes to DartDoc. Cc: @gspencergoog @jcollins-g

[jcollins-g]

Filed as dart-lang/dartdoc#1815.

[SogoGolf]

Microsoft Azure do this really well with large, clear "Feedback" widget at bottom of each developer docs page. What I really like about that is that it keeps the developer (me!) right in the context of what I'm doing/looking for - rather than having to go across to Github, maybe login, find the right repo, open a ticket,..etc etc etc

Here is a screenshot of what I'm referring to on Microsoft Azure. Something similar would be brilliant and super helpful for Flutter.

Finding the Flutter equivalent was for me at least not obvious.

Perhaps just use Firebase's - perfect !