Scratchpad Context Menu

classic Classic list List threaded Threaded
8 messages Options
Reply | Threaded
Open this post in threaded view
|

Scratchpad Context Menu

Rob Campbell-3
Hi all,

During a recent discussion with a colleague, we agreed that the top-level menu item in the Scratchpad named "Context" was too easily-confused with the right-click context menu in the text area. So we're looking for an alternate name.

The menu is used to choose either a "content" or "chrome" context in which to evaluate JavaScript. Other suggestions were, "Environment", "Playground", "Enclosure", "Sandbox", ...

Each of these have merits, though I think Environment was the current front-runner. Sandbox is possibly a good second candidate and also refers to the underlying execution environment. Since that menu includes a Reset menu item, whatever we choose for the top-level menu name should make sense if you "reset" it.

(In this case, resetting context means to create a new sandbox to execute JS in. It will wipe out any variables or functions you may have defined in the Scratchpad.)

I've created bug 657136 to capture the work for this:
https://bugzilla.mozilla.org/show_bug.cgi?id=657136

Thanks for your feedback,
Rob Campbell
Firefox Developer Tools
_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n
Reply | Threaded
Open this post in threaded view
|

Re: Scratchpad Context Menu

Jesper Kristensen-4
Den 14-05-2011 17:25, Rob Campbell skrev:

> Hi all,
>
> During a recent discussion with a colleague, we agreed that the top-level menu item in the Scratchpad named "Context" was too easily-confused with the right-click context menu in the text area. So we're looking for an alternate name.
>
> The menu is used to choose either a "content" or "chrome" context in which to evaluate JavaScript. Other suggestions were, "Environment", "Playground", "Enclosure", "Sandbox", ...
>
> Each of these have merits, though I think Environment was the current front-runner. Sandbox is possibly a good second candidate and also refers to the underlying execution environment. Since that menu includes a Reset menu item, whatever we choose for the top-level menu name should make sense if you "reset" it.
>
> (In this case, resetting context means to create a new sandbox to execute JS in. It will wipe out any variables or functions you may have defined in the Scratchpad.)
>
> I've created bug 657136 to capture the work for this:
> https://bugzilla.mozilla.org/show_bug.cgi?id=657136
>
> Thanks for your feedback,
> Rob Campbell
> Firefox Developer Tools

While "context" might be confusing, I think that the contents of that
menu "content" and "chrome" might be even more confusing. I think many
web developers have never heard the word "chrome" except for Google
Chrome, and "content" could mean anything. It also seems that "content"
means a specific tab. Apparently it means the tab which was selected
when the Scratchpad window was opened. That is not obvious, and even if
you know, there is nowhere where you can see it if you forget which tab
it is.

Also I do not have "chrome" in the menu, only "content" and "reset".

Jesper Kristensen
_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n
Reply | Threaded
Open this post in threaded view
|

Re: Scratchpad Context Menu

Marco Bonardo-2
Il 14/05/2011 17:59, Jesper Kristensen ha scritto:

> Den 14-05-2011 17:25, Rob Campbell skrev:
> While "context" might be confusing, I think that the contents of that
> menu "content" and "chrome" might be even more confusing. I think many
> web developers have never heard the word "chrome" except for Google
> Chrome, and "content" could mean anything. It also seems that "content"
> means a specific tab. Apparently it means the tab which was selected
> when the Scratchpad window was opened. That is not obvious, and even if
> you know, there is nowhere where you can see it if you forget which tab
> it is.
>
> Also I do not have "chrome" in the menu, only "content" and "reset".

You have to enable devtools.chrome.enabled to see chrome.

Btw, the fact about devs not being aware of content/chrome is an
interesting point (well less interesting for chrome since you have to
explicitly enable it), maybe could be "priviledged, unpriviledged" or
something like that.
-m
_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n
Reply | Threaded
Open this post in threaded view
|

Re: Scratchpad Context Menu

Blair McBride (Unfocused)
In reply to this post by Rob Campbell-3
On 15/05/11 03:25, Rob Campbell wrote:
> Each of these have merits, though I think Environment was the current
> front-runner. Sandbox is possibly a good second candidate and also
> refers to the underlying execution environment. Since that menu
> includes a Reset menu item, whatever we choose for the top-level menu
> name should make sense if you "reset" it.

+1 for "Environment". Especially when considering "reset" - you don't
reset a context, but it makes sense to reset an environment. Although
wording of the "Reset" menuitem could be more succinct - I had no idea
what it did before reading your description (putting it under an
Environment menu will help).

My only other suggestion would be "Scope", but that's a much more
technical term, and I'm betting it doesn't translate well in many locales.

- Blair
_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n
Reply | Threaded
Open this post in threaded view
|

Re: Scratchpad Context Menu

Rimas Kudelis
In reply to this post by Jesper Kristensen-4
Hello,

2011.05.14 18:59, Jesper Kristensen rašė:
> Den 14-05-2011 17:25, Rob Campbell skrev:
>> During a recent discussion with a colleague, we agreed that the
>> top-level menu item in the Scratchpad named "Context" was too
>> easily-confused with the right-click context menu in the text area. So
>> we're looking for an alternate name.

I wouldn't say so. Context is I think a known word for developers, is it
not?

> While "context" might be confusing, I think that the contents of that
> menu "content" and "chrome" might be even more confusing.

Totally agreed. I left those untranslated for now simply because I don't
understand what the actual difference between those options is. Plus, I
don't think "chrome" would translate easily into other languages. You
may want to at least add an L10n note suggesting alternatives there
(e.g. "Application" or something).

> I think many
> web developers have never heard the word "chrome" except for Google
> Chrome, and "content" could mean anything. It also seems that "content"
> means a specific tab. Apparently it means the tab which was selected
> when the Scratchpad window was opened. That is not obvious, and even if
> you know, there is nowhere where you can see it if you forget which tab
> it is.

I've noticed that too. It's not the scope of this thread, but Rob, have
you tried to execute alert('whatever') from Scratchpad? It fires a
tab-modal dialog, which is potentially hidden behind the Scratchpad
window, and I can't click the OK button on that dialog without hiding
the Scratchpad window. This doesn't sound like pleasant experience at
all. Maybe Scratchpad should be converted to a panel similar to Web
Console, or to something similar to Web Console's Inspector window?

Rimas


_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n
Reply | Threaded
Open this post in threaded view
|

Re: Scratchpad Context Menu

Rob Campbell-3
In reply to this post by Marco Bonardo-2
On Sunday, 15 May 2011 06:50:51 UTC-3, Marco Bonardo  wrote:
[...]
> Btw, the fact about devs not being aware of content/chrome is an
> interesting point (well less interesting for chrome since you have to
> explicitly enable it), maybe could be "priviledged, unpriviledged" or
> something like that.

Interesting, though I'm not sure I like the vagueness of those terms. Maybe Content and Browser instead of "Chrome"? Applicable since the Scratchpad executes in the scope of the Browser Window when running in "Chrome" context.
_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n
Reply | Threaded
Open this post in threaded view
|

Re: Scratchpad Context Menu

Rob Campbell-3
In reply to this post by Rimas Kudelis
On Sunday, 15 May 2011 16:36:24 UTC-3, Rimas Kudelis  wrote:

> Hello,
>
> 2011.05.14 18:59, Jesper Kristensen rašė:
> > Den 14-05-2011 17:25, Rob Campbell skrev:
> >> During a recent discussion with a colleague, we agreed that the
> >> top-level menu item in the Scratchpad named "Context" was too
> >> easily-confused with the right-click context menu in the text area. So
> >> we're looking for an alternate name.
>
> I wouldn't say so. Context is I think a known word for developers, is it
> not?

It is. That's why I originally chose it. Unfortunately, it becomes problematic when trying to refer to the actual menu. I had a fun conversation with someone trying to enable the chrome context "from the context menu" ("no not *that* one") that kind of highlighted the problem for me. :)

> > While "context" might be confusing, I think that the contents of that
> > menu "content" and "chrome" might be even more confusing.
>
> Totally agreed. I left those untranslated for now simply because I don't
> understand what the actual difference between those options is. Plus, I
> don't think "chrome" would translate easily into other languages. You
> may want to at least add an L10n note suggesting alternatives there
> (e.g. "Application" or something).

Yeah, that's another possibility. What about "Browser" instead of "Chrome"?

The word "chrome" is so prevalent in our source code, it never occurred to me that it might be a problem to include in UI.

> > I think many
> > web developers have never heard the word "chrome" except for Google
> > Chrome, and "content" could mean anything. It also seems that "content"
> > means a specific tab. Apparently it means the tab which was selected
> > when the Scratchpad window was opened. That is not obvious, and even if
> > you know, there is nowhere where you can see it if you forget which tab
> > it is.
>
> I've noticed that too. It's not the scope of this thread, but Rob, have
> you tried to execute alert('whatever') from Scratchpad? It fires a
> tab-modal dialog, which is potentially hidden behind the Scratchpad
> window, and I can't click the OK button on that dialog without hiding
> the Scratchpad window. This doesn't sound like pleasant experience at
> all. Maybe Scratchpad should be converted to a panel similar to Web
> Console, or to something similar to Web Console's Inspector window?

Not really able to reproduce that, Rimas. Executing | alert("whatever") | in content pops up the tab modal dialog. Running it against chrome slides one of the browser alerts out.

Maybe file a bug for that issue.

Thanks for the feedback!

~ rob
_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n
Reply | Threaded
Open this post in threaded view
|

Re: Scratchpad Context Menu

Marco Bonardo-2
In reply to this post by Rob Campbell-3
Il 18/05/2011 16:08, Rob Campbell ha scritto:
> On Sunday, 15 May 2011 06:50:51 UTC-3, Marco Bonardo  wrote:
> [...]
>> Btw, the fact about devs not being aware of content/chrome is an
>> interesting point (well less interesting for chrome since you have to
>> explicitly enable it), maybe could be "priviledged, unpriviledged" or
>> something like that.
>
> Interesting, though I'm not sure I like the vagueness of those terms. Maybe Content and Browser instead of "Chrome"? Applicable since the Scratchpad executes in the scope of the Browser Window when running in "Chrome" context.

If the component is only part of browser apps, Browser may be fine, if
it may be used by any xulrunner app, then Application is probably better.
-m
_______________________________________________
dev-l10n mailing list
[hidden email]
https://lists.mozilla.org/listinfo/dev-l10n