[wp-trac] [WordPress Trac] #39015: Customize: custom CSS help link is not helpful

[WordPress Trac]

#39015: Customize: custom CSS help link is not helpful
------------------------------+-------------------------
 Reporter:  celloexpressions  |      Owner:
     Type:  defect (bug)      |     Status:  new
 Priority:  normal            |  Milestone:  4.7
Component:  Customize         |    Version:  trunk
 Severity:  critical          |   Keywords:  needs-patch
  Focuses:  docs              |
------------------------------+-------------------------
 I just realized that the custom CSS help text still points to what was
 intended as a temporary/placeholder link:
 https://codex.wordpress.org/Know_Your_Sources#CSS.

 There are numerous problems with this link, but the biggest is that it's
 linking to a place on a page, which causes confusion when users start
 scrolling through to find what they're looking for (see user testing
 https://make.wordpress.org/design/2016/11/04/4-7-beta-1-user-testing-in-
 the-customizer-and-with-twenty-seventeen/). The page is on the Codex and
 mostly contains a number of links. We can do much better over time, but
 with the link in core we're currently stuck with this location for
 building out that documentation.

 Can we make a placeholder handbook page for custom CSS for now? Maybe
 https://developer.wordpress.org/themes/basics/additional-css/? That could
 move to a user handbook in the future and generally continue to be built
 out separately from core, but the current link is not in a good place for
 that documentation to be built out over time. The link is translatable, so
 this would be a string change; however, putting in 4.7 for now for
 tracking.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/39015>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform