Some possibilities for linking to more relevant help pages when creating Implementations (or other objects in the future)

Option 1

Reuse current "(?) Help" link from mediawiki special page configuration

• pro: it's an existing UI element
• con: for that reason, editors used to it might ignore it
• con: a bit outside of the immediate context, might make it less noticeable
• con: we need to understand what kind of content we are editing (e.g. implementation vs tester) at php level and conditionally change the link; this might be a bit dirty

Option 2

Use contextual right corner of "Contents" box for a help link, if the content needs it. For example, if we detect that the

• pro: extremely simple to conditionally select an appropriate link (e.g. show help for implementation, a different one for test, nothing for the other types)
• con: an extra help icon, which may be visually redundant

Different possibilities for the element include: full link, help link with tooltip, icon with tooltip, or others.

icon and full link	text link	help link with tooltip	icon with tooltip

Option 3

Even more contextual, beside "implementation" label only in the implementation page.

• pro: extremely contextual and close to the user action
• con: only applicable for this use case, if we want to add help links for other types we'd have to figure out where and how to put those in those cases (option 2 would be valid for everything)

An example, but not the only possibility:

@JSengupta-WMF @LMorgantini-WMF could you take a look and share your thoughts?

Change #1218227 had a related patch set uploaded (by Genoveva Galarza; author: Genoveva Galarza):

[mediawiki/extensions/WikiLambda@master] [WIP] possible displays of implementation help link

https://gerrit.wikimedia.org/r/1218227

After chatting with @JSengupta-WMF we decided:

• Let's implement a link for discovering the implementation related documentation
• Let's chat next Q about how to generalize this approach to other types
• Favorite approach: link on top of Content box, with smaller text display when mobile (e.g. "How to...?")

Change #1218227 merged by jenkins-bot:

[mediawiki/extensions/WikiLambda@master] Display contextual "Howto" link for implementation pages.

https://gerrit.wikimedia.org/r/1218227