website icon indicating copy to clipboard operation
website copied to clipboard

Update error docs to use PlatformDispatcher instead of Zones

Open dnfield opened this issue 3 years ago • 3 comments

New API will be available for the upcoming stable release. This should not be published until available in stable.

We are trying to discourage people from using Zones - it causes performance issues and generally contributes to confusion. The new API handles all errors without the need for custom zones. Current docs are available here: https://master-api.flutter.dev/flutter/dart-ui/PlatformDispatcher/onError.html

@zanderso FYI

dnfield avatar Aug 10 '22 18:08 dnfield

@khanhnwin - What's the process for queuing documentation changes for a stable release? I presume there will be a special branch somewhere? Anyway, whatever that looks like, let's add this to it :)

craiglabenz avatar Aug 10 '22 23:08 craiglabenz

Hi y'all!

Yep, that's correct. There's a process for stable release documentation changes. I just sent an email that covers it, subject: "docs.flutter.dev website freeze". @dnfield I'll send out an email next week with the full instructions!

khanhnwin avatar Aug 11 '22 00:08 khanhnwin

@khanhnwin Let's try to ferry this across the goal line for Dan and not make him think about it again. I'm happy to help, as well :)

craiglabenz avatar Aug 11 '22 15:08 craiglabenz

Yeah, we don't want to land this here, now, Once we freeze the website (8/17), we can deal with it then.

sfshaza2 avatar Aug 11 '22 17:08 sfshaza2

Hey @dnfield - I sent out an email with instructions for landing contributing to docs for the next stable release! Please let me know if you have any questions. Thanks!

khanhnwin avatar Aug 17 '22 23:08 khanhnwin

This has been taken care of. Thanks, @dnfield! Closing.

sfshaza2 avatar Aug 25 '22 19:08 sfshaza2