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

"sidepane" v/ "side panel" v/ "sidebar" #33

Open
ghost opened this issue Jul 4, 2016 · 10 comments
Open

"sidepane" v/ "side panel" v/ "sidebar" #33

ghost opened this issue Jul 4, 2016 · 10 comments
Labels
section-terminology an issue in the terminology table type-enhancement an enhancement

Comments

@ghost
Copy link

ghost commented Jul 4, 2016

Lots of interesting possibilities here: one word or two? with L or without? Is a "bar" the same as a "pane"?

@ghost ghost added type-enhancement an enhancement section-terminology an issue in the terminology table labels Jul 4, 2016
@dmpop
Copy link
Contributor

dmpop commented Mar 6, 2017

Sidebar: fixed position, can be toggle (hide/show). I think both side bar and sidebar are acceptable, although I personally prefer the latter.
Side panel: panel as a UI element is usually movable. This means that a side panel becomes just a panel when moved. So it's better to refer to a panel by its name and not its position.
Side pane: again, it's better to refer to the specific pane by its name, not position. Also, pane is part of a window, so use it when the main UI element is window.

@dariavladykina
Copy link
Contributor

There is inconsistency throughout the documentation. For example, 'side bar' and 'sidebar' versions may pop up together in the same book.

@dariavladykina
Copy link
Contributor

Let's add these to TermWeb:

sidebar - An auxiliary window on screen that is displayed alongside the main window. (PC Mag)

side panel - The side panel is a reserved area along the side of your dashboard that you can use to give your dashboard more context, provide additional information to users, and more. (from here)

side pane - A section of a window that provides the user with additional information or quick access to features commonly used in a software program. (Computer Hope)

Feel free to discuss!

@PadraigDillon1
Copy link

These all seem like good definitions and good candidates to add to TermWeb.

@dariavladykina
Copy link
Contributor

Added to TermWeb

@mauricio-lomeli-planview

Sidebar: fixed position, can be toggle (hide/show). I think both side bar and sidebar are acceptable, although I personally prefer the latter. Side panel: panel as a UI element is usually movable. This means that a side panel becomes just a panel when moved. So it's better to refer to a panel by its name and not its position. Side pane: again, it's better to refer to the specific pane by its name, not position. Also, pane is part of a window, so use it when the main UI element is window.

I hope developers and engineers up vote this comment. It makes the most sense architecturally.

@cwickert
Copy link
Member

I think neither of these definitions makes sense for us and should not be in TermWeb.

  1. PC Mag, ArcGIS, or "Computer Hope" (huh?) are by no means authoritative for us. PC Mag for example bases their definition on the old Windows 7 sidebar, which was something completely different (it was part of the desktop, not an application window).
  2. We cannot and must not define these terms in TermWeb. We can only document what is out there, and this is quite diverse. Even though different projects share the same terminology, the actual meaning is different. Most sidebars are on the right and do something to the window's main area (e.g. open a folder you select in the sidebar), but then LibreOffice has a sidebar on the left that is context-sensitive to the main area (i. e. it displays information based on the selection). Given this diversity, we need to stick to upstream terminology and definitions. We only can advise our writers what term to use in which context.

Most important upstreams:

@dariavladykina
Copy link
Contributor

Stylewich meeting digest:
remove 'side panel' from terms
'side pane'
'sidebar' - create new definition, e.g. a vertical panel used in Gnome, KDE, Mozilla products, and LibreOffice programs

@dariavladykina
Copy link
Contributor

"Sidebar" definition: in the context of software applications like those found in Gnome, KDE, Mozilla and LibreOffice, a vertical panel typically located on the edge of a digital interface that provides supplementary information, tools or navigation options.

@mauricio-lomeli-planview

One day, we will have a standard. One day... **hopeful** wishing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
section-terminology an issue in the terminology table type-enhancement an enhancement
Projects
None yet
Development

No branches or pull requests

5 participants