Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Explain the switch of context better #21

Open
gnunicorn opened this issue Apr 27, 2013 · 3 comments
Open

Explain the switch of context better #21

gnunicorn opened this issue Apr 27, 2013 · 3 comments

Comments

@gnunicorn
Copy link
Member

"Select the other option" is really vage and people dont even find the thing to look for. Maybe a screenshoot would help?

@xMartin
Copy link
Member

xMartin commented Oct 4, 2017

The issue refers to this text on page 1:

If you want to inspect the environment of a page shown in the
sandbox, you have to take an extra step. If you open a console on that
tab, and you type myMessage into it, it won't find that
variable. This is because the console is connected to the sandbox page
itself, not the page shown inside of it. At the top left of the console,
there is a control that says <top>. Click on
this and select the option with the name of the domain that is
shown in the address bar of the browser to connect the console to the
actual page we wrote.

I think we already improved it. Let's double-check if it's good enough.

@andi-dev
Copy link

I was just sitting next to a complete beginner who got entirely confused and stuck by that passage.
It was not clear to her what is meant by the newly introduced term "environment", and it was confusing that, when clicking on 'top' she was seeing two options with the "name of the domain shown in the address bat", "top" and "about:blank". When choosing "about:blank" the dropdown turned red, leaving the impression to have made a wrong choice.

Maybe we could at least mention the "about:blank"? I know its hard at this point to start introducing the concept of iframes...

@xMartin
Copy link
Member

xMartin commented May 30, 2019

It's gonna be hard to find the right words for everybody. I also think screenshots could be more helpful.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants