Rename "Toggle Dialogs" (sometimes "Windows") to "Panel"

[Klumbumbus]

In JOSM and in the wiki we use both terms mixed. We should decide which one should be used, so it is easier to the user to understand. Currently this causes also problems like F1 on the "Windows" menu leads to the empty page Help/Menu/Windows. (Content is currently on Help/ToggleDialogs).

I vote for "Windows" as this is easier to understand and already used most of the time.

[michael2402]

I don't like the term "ToggleDialog". Their visibility can be toggled by a button but this does not really qualify for this name.

The problem I see with "Windows" is, that users may confuse them with the other windows we have (main window, ...).

What about "Dockable Window"?

[michael2402]

Can we decide on a name here?

[Klumbumbus]

Replying to michael2402:

Can we decide on a name here?

+1

What about "Dockable Window"?

I would agree with this solution.

[stoecker]

In 11769/josm:

see #14142 - fix help link

[stoecker]

In 11770/josm:

see #14142 - fix another help link

[stoecker]

"Dock" or "Dockable window" is fine for me as well (depending whether we need a short or long form). Long form should be preferred.

[Klumbumbus]

Replying to Klumbumbus:

What about "Dockable Window"?

I would agree with this solution.

However, the docu would sound a bit strange, e.g.: "...open the Tags/Membership dockable window via the Dockable Window menu..." A single word would be better.

[Klumbumbus]

I'm just wondering what the german transation for "dock" and "dockable window" would be.

[stoecker]

​http://www.linguee.com/english-german/search?source=auto&query=dockable+window --> Andockbares Fenster.

and ...open the Tags/Membership dockable window via the Window menu... sounds much better.

[Klumbumbus]

Replying to stoecker:

​http://www.linguee.com/english-german/search?source=auto&query=dockable+window --> Andockbares Fenster.

OK, but whats the german translation for the short form "dock"?

and ...open the Tags/Membership dockable window via the Window menu... sounds much better.

That would be inconsistent again, if we want to keep the term "window" for all the other "undockable pop up windows", see comment:1

[michael2402]

Why not just call them Docks then?

In German, it is much easier to find a single word for everything: Andockfenster ;-)

[bastiK]

I don't like dock as a noun too much, the primary association would be a maritime dock and the dock itself doesn't dock=attach to something, the ships that come into the harbor do. Compare the ​Dock in macOS, which is the global prominent taskbar at a fixed position.

We could call it "dockable window" whenever that sounds okay, and otherwise just "window". The short form makes no distinction between dockable and modal windows, but it can't be helped. At least everyone knows what a window is.

[Don-vip]

Status of dockable windows in major software, how they name it:

1. ​Eclipse: Views and Editors in the "Window" menu.
2. ​Netbeans: Windows and Editors in the "Window" menu
3. ​Visual Studio: Docking Windows in the "Window" menu
4. ​Photoshop: Document Windows and Panels in the "Window" menu.
5. ​GIMP: Dockable Dialogs in the "Windows" menu
6. ​Blender: They chose to not implement dockable panels

The "Window" menu seems universal. I suggest to keep it.

Concerning the name, all English names suggested are fine so the translation should be our main concern. "Panel" is probably the easiest to translate in all languages and is short. In French we would go for "Fenêtre ancrable" for either "docking/dockable window/dialog" but "Panneau" is simpler.

[michael2402]

For me, a window is something that I can move around the screen. The problem I see with just calling it window is, that most new users don't know that you can move them around.

Just looked around a bit...

Gimp: They call it "dockable dialogs" (German: Andockbare Dialoge), short form: Docks.
Incscape just calls it dialog in the docs, but often refers to it as "Dockable Dialogs" (or docked dialogs as long as they are really docked) and ​Floating dialogs.
Blender has a "Tool Shelf" (shelf) on the side of it's main window.
Photoshop calls them "Panel"

So we are left with some more names to confuse people: "panel", "dockable panel", "dialog", "dockable dialog", ... ;-)

Edit: Some seconds to slow ...
Edit 2: I agree that we should also unify the translations for this. We should always use the same word in very translated language. We will have the same problem again if we mix "Panel" with several native words for panel...

[Don-vip]

Replying to michael2402:

Edit: Some seconds to slow ...

Great minds think alike :)

[bastiK]

+1 for panel

[Klumbumbus]

German translation would be "Panel" and plural "Panels" then, right? ​http://www.duden.de/rechtschreibung/Panel

[stoecker]

Replying to Klumbumbus:

German translation would be "Panel" and plural "Panels" then, right? ​http://www.duden.de/rechtschreibung/Panel

Nein, das ist die Übersetzung der falschen Bedeutung: ​http://dict.leo.org/englisch-deutsch/panel

Paneel → Paneele wäre die richtige Form. Wobei mir Feld oder Tafel besser gefallen würde.

[michael2402]

Replying to stoecker:

Replying to Klumbumbus:

German translation would be "Panel" and plural "Panels" then, right? ​http://www.duden.de/rechtschreibung/Panel

Nein, das ist die Übersetzung der falschen Bedeutung: ​http://dict.leo.org/englisch-deutsch/panel

Paneel → Paneele wäre die richtige Form. Wobei mir Feld oder Tafel besser gefallen würde.

Paneel/Paneele is acceptable. The problem with "Feld" and "Tafel" is that they do not relate to the English word. It will be hard to tell this to translators and even harder for people that are not translators but simply use JOSM in a multi-lingual setting (e.g. English tutorials, ...)

[Klumbumbus]

​https://de.wikipedia.org/wiki/Panel

Bei wikipadia würde Panel passen "Panel, in der Informatik ein einfaches grafisches Gestaltungselement, das von einem Layoutmanager positioniert wird."

wohingegen Paneel mit zwei e: "Paneel, im Sinne von (Holz-)Täfelung bzw. Wand- oder Deckenverkleidung"

[stoecker]

Replying to Klumbumbus:

​https://de.wikipedia.org/wiki/Panel

Bei wikipadia würde Panel passen "Panel, in der Informatik ein einfaches grafisches Gestaltungselement, das von einem Layoutmanager positioniert wird."

That's no translation, but taking the English word. Sometimes this is the best solution. I'm not so sure in this case for an element which has enough German translation possibilities. The informatics "Panel" in German is not really used by end-users, only by developers and scientists (and also pronounced like the English word BTW).

Replying to michael2402:

Paneel/Paneele is acceptable. The problem with "Feld" and "Tafel" is that they do not relate to the English word. It will be hard to tell
this to translators and even harder for people that are not translators but simply use JOSM in a multi-lingual setting (e.g. English
tutorials, ...)

There is no need to follow the English original. I18N is more than a simple translation. This would not be the first case where the translation differs from the English original, see the German translation page for notes.

[Don-vip]

If we change it to "panel", I don't know how to rephrase this. "Toggle panels panel" is not great :D

    public DialogsToggleAction() {
        super(tr("Toggle dialogs panel"),
              (ImageProvider) null, /* no icon */
              tr("Toggle dialogs panel, maximize mapview"),
              Shortcut.registerShortcut("menu:view:dialogspanel", tr("Toggle dialogs panel"), KeyEvent.VK_TAB, Shortcut.DIRECT),
              true, "dialogspanel", /* register in toolbar */
              false
        );
        putValue("help", ht("/ToggleDialogs"));
        setSelected(Config.getPref().getBoolean("draw.dialogspanel", true));
        notifySelectedState();
    }

[bastiK]

In 13090/josm:

see #14142 - move dialogs toggle action menu entry down to toolbar toggle actions

[bastiK]

Replying to Don-vip:

If we change it to "panel", I don't know how to rephrase this. "Toggle panels panel" is not great :D

There may be better wordings, but "Panel area" would be fine. (With [13090])

[Don-vip]

Replying to bastiK:

"Panel area" would be fine

I like it :)

[Klumbumbus]

I'm not yet really happy with the german translation (singular "Paneel", plural "Paneele"). When I hear "Paneele" I always think of ​this

(​google picture search)

[bastiK]

Replying to michael2402:

Replying to stoecker:

Paneel → Paneele wäre die richtige Form. Wobei mir Feld oder Tafel besser gefallen würde.

Paneel/Paneele is acceptable. The problem with "Feld" and "Tafel" is that they do not relate to the English word. It will be hard to tell this to translators and even harder for people that are not translators but simply use JOSM in a multi-lingual setting (e.g. English tutorials, ...)

Replying to Klumbumbus:

I'm not yet really happy with the german translation (singular "Paneel", plural "Paneele"). When I hear "Paneele" I always think of ​this

What about "Bearbeitungsfeld" or "Arbeitsfeld", which can optionally be shortened to "Feld": "Ebenen-Bearbeitungsfeld", "Minikarten-Feld", "Bearbeitungsfeld für Kartenzeichenstile", ...

[Don-vip]

@Klumbumbus: I think now's a good time to make the switch.

[Klumbumbus]

Replying to bastiK:

What about "Bearbeitungsfeld" or "Arbeitsfeld", which can optionally be shortened to "Feld": "Ebenen-Bearbeitungsfeld", "Minikarten-Feld", "Bearbeitungsfeld für Kartenzeichenstile", ...

"Arbeitsfeld" is good. This provides also a good wording as a whole with the other GUI elements (where the german wording in JOSM and the wiki is a mess atm too):

• up "Hauptwerkzeugleiste"
• left "Arbeitswerkzeugliste" which includes the "Arbeitsmodi" in the upper part and the buttons for the "Arbeitsfelder" in the lower part
• right "Arbeitsfelder"

[Klumbumbus]

Replying to Don-vip:

I think now's a good time to make the switch.

So, lets summarize:

English: "Panel"
German: "Arbeitsfeld"
French: "Panneau" ??

The word "Window" is kept for "classic" not dockable windows like the preferences, download or relation editor windows.

Any objections left?

[Don-vip]

No objection.

[Klumbumbus]

I would be grateful if someone else makes the changes as I have not really an idea atm how to safely find all occourences and if file names should be renamed too and which consequences this would have... :)

[Don-vip]

OK I'll take a look. I won't rename the Java classes, this would break all plugins. Only the translated strings. I'll let you handle the wiki, deal? ;)

[Klumbumbus]

Deal. :D

[Hb---]

Replying to Klumbumbus:

German: "Arbeitsfeld"
Any objections left?

Bedienfeld (einzelne Einheit) und
Bedienfeldertafel Bedienfelderstapel (Getoggelt mit TAB)

[Hb---]

Replying to Klumbumbus:

... like F1 on the "Windows" menu leads to the empty page Help/Menu/Windows. ...

How to press F1 in the menu? Who can help be invoked there? Needs it to be activated?

Replying to Klumbumbus:

What about "Dockable Window"?

However, the docu would sound a bit strange, e.g.: "...open the Tags/Membership dockable window via the Dockable Window menu..." A single word would be better.

A single word is much easier for translation.

Replying to Klumbumbus:

Replying to stoecker:

​http://www.linguee.com/english-german/search?source=auto&query=dockable+window --> Andockbares Fenster.

OK, but whats the german translation for the short form "dock"?

and ...open the Tags/Membership dockable window via the Window menu... sounds much better.

That would be inconsistent again, if we want to keep the term "window" for all the other "undockable pop up windows", ...

Do we want to keep "window" for all the rest? No, see comment:50

Replying to michael2402:

Why not just call them Docks then?
In German, it is much easier to find a single word for everything: Andockfenster ;-)

A "dock" is favourable to keep all "panels" together.

Replying to Don-vip:

The "Window" menu seems universal. I suggest to keep it. ...
Concerning the name, all English names suggested are fine so the translation should be our main concern. "Panel" is probably the easiest to translate in all languages and is short. ..

Fine.

Replying to michael2402:

For me, a window is something that I can move around the screen. The problem I see with just calling it window is, that most new users don't know that you can move them around. ...
Photoshop calls them "Panel"
So we are left with some more names to confuse people: "panel", "dockable panel", "dialog", "dockable dialog", ... ;-)
Edit 2: ... We should always use the same word in very translated language.

This responsibility is more on the translators side. For european languages it seems easy. But languages from overseas might have other values. The source code can only encourage unity with being very strict in its wording.

We will have the same problem again if we mix "Panel" with several native words for panel...

How can this happen?

Replying to stoecker:

German translation would be "Panel" and plural "Panels" then, right? ​http://www.duden.de/rechtschreibung/Panel

Nein, das ist die Übersetzung der falschen Bedeutung: ​http://dict.leo.org/englisch-deutsch/panel
Paneel → Paneele wäre die richtige Form. Wobei mir Feld oder Tafel besser gefallen würde.

Der vierte Treffer in ​http://dict.leo.org/englisch-deutsch/panel weist auf "die Tafel". Das wäre noch in Ordnung.

Replying to michael2402:

Paneel/Paneele is acceptable. The problem with "Feld" and "Tafel" is that they do not relate to the English word. It will be hard to tell this to translators and even harder for people that are not translators but simply use JOSM in a multi-lingual setting (e.g. English tutorials, ...)

The word "Feld" is bad, because it is already used in Eingabefeld or Dialogfeld.
Why does "Tafel" for German inflict the international use?

Replying to bastiK:

Replying to Don-vip:

If we change it to "panel", I don't know how to rephrase this. "Toggle panels panel" is not great :D

There may be better wordings, but "Panel area" would be fine. (With [13090])

Similar to above "area" is a already used in OSM for an object and therefore not the best option to describe the GUI.

Possible terms for the group of panels visible on the right-hand-side are

• Panel stack according to hay stack or
• DockSidebar as harbour for the panels that do not float. Dock has the advantage of being only one word. And "Toggle dock" seems good to describe an action. (Redacted, see comment:62)

Replying to Klumbumbus:

Replying to bastiK:

What about "Bearbeitungsfeld" or "Arbeitsfeld", which can optionally be shortened to "Feld": "Ebenen-Bearbeitungsfeld", "Minikarten-Feld", "Bearbeitungsfeld für Kartenzeichenstile", ...

"Arbeitsfeld" is good. This provides also a good wording as a whole with the other GUI elements (where the german wording in JOSM and the wiki is a mess atm too):

• up "Hauptwerkzeugleiste",
• left "Arbeitswerkzeugliste" which includes the "Arbeitsmodi" in the upper part and the buttons for the "Arbeitsfelder" in the lower part
• right "Arbeitsfelder"

When the "Arbeit-" prefix fits for three parts of the screen it may be confusing. In original English as in the translations different terms should be used for different things. The more distinct, the better.

Replying to Klumbumbus:

The word "Window" is kept for "classic" not dockable windows like the preferences, download or relation editor windows.

We should avoid "Window" as much as possible because it in-distinctively fits for everything. And because it was used for the 'things' on the right hand side. Calling the RE now "Relation Editor window" will confuse existing help forum content with the former "Relation window".

So "Dialog" should be used to name the other floating GUI items. The changeset thing is currently named "Changeset Management Dialog" which is fine.

Conclusion so far:

• Panel for each of the single dockable windows.
• DockSidebar for the whole toggable group on the right-hand-side. (Redacted, see comment:62)
• Keep Dialog for the rest, independently if modal or not.

It would be fine if this could be decided timely because other bugs (#15918) depend on it.

[Don-vip]

Postpone after we sort out transifex migration issues

[Hb---]

LibreOffice has finally replaced the term Elements dock with Sidebar with their 5.3 release in ​January 2017. My favorite names are now

• Sidebar for the collection of docked panels at the right hand side of the screen
  • The part toggle was important when screens were narrow. But screens have grown an toggling is seldom nowadays. The wording Toggling the sidebar is fine.
  • The word ends with *bar. So having a Main toolbar (Symbol bar), a Sidebar, a Status bar and an Edit toolbar around the MapView seems fine for translators.
• Panel for each list. This is often used in the Help already and may replace the term JOSM Window.

[Klumbumbus]

Removing milestone as it is postponed since 16.12