Additional CSS placeholder text inconsistent with help button placement

[hvianna]

The placeholder text (comment) for additional CSS reads:

/* You can add your own CSS here. Click the help icon above to learn more. */

But the help button is actually placed below the textarea.

[swissspidy]

For accessibility reasons we probably shouldn't mention the location at all.

[afercia]

@hvianna maybe because you're using Jetpack custom css, it adds a Help link at the bottom. WordPress has only the help button above the textarea. See screenshot:

Also, the two icons give access to different help resources. Maybe the Jetpack link should clarify that it specifically refers to Jetpack.

@swissspidy yep maybe a better wording would help. In [37680] we've changed upper left in favour of above, I think it's OK because it suggests a "logical" position and not a "visual" position. Any improvements welcome :)

[celloexpressions]

Jetpack should integrate with the core help button by replacing or extending the custom_css section's description via $wp_customize->get_section( 'custom_css' )->description = __( 'help text' );. There's no need to add another button on their end as that would only cause confusion and fragment the documentation. cc @georgestephanis

[hvianna]

Replying to afercia:

@hvianna maybe because you're using Jetpack custom css, it adds a Help link at the bottom. WordPress has only the help button above the textarea. See screenshot:

I'm really sorry for the confusion, I should've paid more attention to the screen. Thank you for clearing that out!

[georgestephanis]

Placement was directed by @folletto -- I'll follow up with him privately for our help location or overwriting Core's link target.

[folletto]

Replying to georgestephanis:

Placement was directed by @folletto -- I'll follow up with him privately for our help location or overwriting Core's link target.

The suggestion in this thread is meant to happen. We simply didn't make it in time for the release.
So I confirm, ideally it should just override the global (?) icon.

The background of that reason is that Jetpack is basically a step ahead implementing the Core's design proposal outlined here: #38707

[jeherve]

Replying to afercia:

@swissspidy yep maybe a better wording would help. In [37680] we've changed upper left in favour of above, I think it's OK because it suggests a "logical" position and not a "visual" position. Any improvements welcome :)

If we ever make changes to that help message, it might be worth clarifying here in that message, as some site owners take this a bit too literally and paste their CSS right after here, in the CSS comment.