Unhelpful generic deprecation notice

[crcdng]

On May 6, 2025, the official Flutter account on Twitter promotes the following article on docs.flutter.dev:

https://x.com/FlutterDev/status/1919814420416381051
https://docs.flutter.dev/cookbook/effects/gradient-bubbles

However, as pointed out by some responses that article contains a (generic) deprecation notice:

Deprecation notice This document is deprecated and will be removed from a future website update.

In order for the reader to understand the situation it would be useful to note why the article is deprecated and which aspect of it. This applies in general, not only to the article mentioned. In that case however, the recommendation on Twitter in combination with the generic deprecation notice is confusing.