PlasmoHQ / plasmo

🧩 The Browser Extension Framework
https://www.plasmo.com
MIT License
10.03k stars 346 forks source link

[EXP] Enhance Documentation on "Worlds" in Content Scripts for Better Clarity #902

Open JKamsker opened 6 months ago

JKamsker commented 6 months ago

What is the example you wish to see?

Hello Plasmo Team,

As someone diving into browser extension development for the first time, I've encountered several domain-specific terms that are somewhat confusing without a solid background in the field. One term that particularly stands out is "world," as mentioned in the context of Content Scripts in your documentation.

Understanding the concept of "worlds" in content scripts is crucial for grasping how browser extensions interact with web pages and how they are isolated from them. However, the current explanation seems to be a bit sparse for beginners like myself. It would be immensely helpful if the documentation could be expanded to include:

  1. A more detailed definition of what "worlds" are, including examples of how they are used in browser extension development.
  2. The significance of different "worlds" (e.g., "isolated world") and how they affect the behavior of content scripts in relation to web pages.
  3. Additional resources or links to external sites that provide a deeper dive into concepts specific to browser development, especially those that are pivotal to understanding how extensions work.

Enhancing the documentation in this manner would not only demystify the concept for newcomers but also make the onboarding process for new developers smoother and more welcoming. It would bridge the gap between general programming knowledge and the specialized domain of browser extension development, ultimately fostering a more inclusive and informed developer community around the Plasmo framework.

Thank you for considering this request. I believe that by making these adjustments, Plasmo can significantly improve its accessibility to developers who are new to this exciting area of software development.

Is there any context that might help us understand?

No response

Code of Conduct