isolates.md no flutter web support

[randomizedcoder]

Flutter web no isolates

Just a small notes into the Isolates page about lack of support in Flutter Web.

---

• [X ] I’ve reviewed the contributor guide and applied the relevant portions to this PR.
• This PR doesn't contain automatically generated corrections or text (Grammarly, LLMs, and similar).
• This PR follows the Google Developer Documentation Style Guidelines — for example, it doesn't use i.e. or e.g., and it avoids I and we (first person).
• This PR uses semantic line breaks of 80 characters or fewer.

flutter/flutter#179083

[gemini-code-assist]

Summary of Changes

Hello @randomizedcoder, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the documentation for Isolates by adding a crucial note regarding their support in Flutter web. The change clarifies that multiple Isolates are not available in Flutter web environments, providing developers with accurate information and a reference to related concurrency documentation, thereby preventing potential confusion and issues.

Highlights

• Documentation Update: Added a flutter-note block to the isolates.md documentation, explicitly stating that multiple Isolates are not supported when using Flutter web.
• External Reference: Included a link to the Concurrency on the web section of the Dart documentation for further details on this limitation.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request adds a note to the isolates.md page to clarify that isolates are not supported on Flutter for web. My review includes suggestions to improve the wording for clarity and correctness, and to align it with the documentation style guide and conventions used in the file.

[gemini-code-assist]

Thanks for adding this note! To improve clarity, correctness, and consistency with the rest of the file and the style guide, I have a few suggestions:

• For consistency with other notes in this file (e.g., line 59), please use five colons (:::::) to open and close the note block instead of three (:::).
• The Google Developer Documentation Style Guide recommends avoiding contractions.¹ "you're" should be "you are".
• The phrase "multiple Isolates" could be misleading. On the web, isolates are not supported at all, not just multiple ones. It would be clearer to say "isolates are not supported".
• "Isolates" should be lowercase when referring to the concept, as is done elsewhere in the documentation.
• The link to the "Concurrency on the web" section should be a relative path (/language/concurrency#...) for consistency with other internal links in this file.
• Sentences should end with a period.

Here is a suggestion that applies all these points:

Suggested change

	:::flutter-note
	If you're using Flutter web, multiple Isolates are not supported.
	See also: [Concurrency on the web](https://dart.dev/language/concurrency#concurrency-on-the-web)
	:::
	:::::flutter-note
	If you are using Flutter web, isolates are not supported.
	See also: [Concurrency on the web](/language/concurrency#concurrency-on-the-web).
	:::::

Style Guide References

Footnotes

1. The Google Developer Documentation Style Guide recommends avoiding contractions like "you're". Use "you are" instead for a more formal tone and to avoid potential misinterpretation. ↩

[antfitch]

We need to avoid adding information about Flutter in the Dart documentation when at all possible, so this is something I'd like to avoid adding to the Dart docs.

Instead, make sure that this is covered in the Flutter documentation here: https://docs.flutter.dev/perf/isolates. If you think something needs to be updated in those docs, feel free to create a PR in https://github.com/flutter/website/pulls.

[randomizedcoder]

@antfitch Maybe you know @tirth-patel-nc ? Maybe you guys want to play rock paper scissors? ;)

12:59 PM (3 hours ago)

tirth-patel-nc  left a comment 
[(flutter/flutter#179083)](https://github.com/flutter/flutter/issues/179083#issuecomment-3577563666)

[@randomizedcoder](https://github.com/randomizedcoder) thanks for the report. however, it belongs in the dart lang site www repo. I recommend filing the issue there instead.

[tirth-patel-nc]

@randomizedcoder links you posted belonged to this repo hence I commented that. https://docs.flutter.dev/perf/isolates was not there in your original report.

[antfitch]

@antfitch Maybe you know @tirth-patel-nc ? Maybe you guys want to play rock paper scissors? ;)

12:59 PM (3 hours ago)

tirth-patel-nc  left a comment 
[(flutter/flutter#179083)](https://github.com/flutter/flutter/issues/179083#issuecomment-3577563666)

[@randomizedcoder](https://github.com/randomizedcoder) thanks for the report. however, it belongs in the dart lang site www repo. I recommend filing the issue there instead.

Hahaha, too funny! We'll get this figured out.

@sfshaza2 we have an issue and I'd love to get your advice. We have Flutter-specific information about isolates that needs to be added somewhere. I'm thinking it would make sense to add this in the Flutter documentation? We've been trying to avoid putting Flutter things in the Dart docs since Dart goes beyond Flutter?

[sfshaza2]

Yes, I see two places where we can add it: 1) In the web FAQ and 2) In the Concurrency and isolates page (https://docs.flutter.dev/perf/isolates). But then maybe a note on the Dart site to reference one or both of those pages to learn about Flutter and isolates.