Thanks yvanzo, looks good!

I will look at fancy help function/toggles in the MB redesign, which will centralise everything into the design-system before being applied site-wide (ideally). I left your note re. not being sure which is on/off.

But while we're on the topic, maybe I'll use similar toggles to the current LB redesign mockup:

After a comment by bitmap to the pull request, and a discussion on IRC #metabrainz with aerozol resulting in his above mock-up, here is an overview for the placement of the new “(help)” toggle link (already used in the tracklist editor for example) as a first implementation. It solves the tab-navigation issue (by placing this link ahead of the first-focused field), requires only one click to show help for both relationship type and attributes which go together anyway.

The fancy CSS toggle switch would be nice to have later on. I’m not sure which one represents the position on though. Maybe it should make it to the design-system repository at first?

How I would imagine doing it in the redesign style, using your suggestion of having a toggle at the top:

Edit: Just a quickie, not sure about the blue colour (but could work to have a new colour for all help/doc related buttons and items)

Trying to address the issue of one [?] box being a tooltip and one making multiple help boxes appear, how about having two types of icons?

Putting the help box to one side may also help with clutter and allow us to add it to other MB pages.

(below has a white dotted outline for the tooltip/mouse-over help button)

We can make them stand out if wanted:

Looks good yvanzo - what about having the [?] box instead of the (help) text?

aerozol, a few reasons not to:
1. The style you mention only applies to fields in half-width column where there is guaranteed free place on the right. Implementing it for the relationship dialog popover wouldn’t be straightforward and would certainly come with some more issues that would further delay the next release.
2. In the longer term, the half-width layout might have to be abandoned anyway to allow supporting mobile devices which have smaller screens.

Attached is an overview of the help toggle link/description for relationship type I implemented, it follows the same style as the help toggle link/description for relationship attributes below. It allows to keep viewing the type’s description while editing attributes.

What about using the same on-click style we use for 'add artist' elements?

Keeps the interface a bit clearer.

Standardizing all the help/doc UX (and making it appealing/easy) is a big goal, another one on my to-do list...

Additionally an help link to the corresponding tree documentation page such as “Artist-Work relationship types” is added when no relationship type is selected.

See code changes in pull request #2866 submitted by yvanzo.