[wp-meta] [Making WordPress.org] #2842: REST API handbook contains incorrect links to Requests class

Making WordPress.org noreply at wordpress.org
Sun May 28 03:12:39 UTC 2017


#2842: REST API handbook contains incorrect links to Requests class
---------------------------+-----------------
 Reporter:  rmccue         |      Owner:
     Type:  defect         |     Status:  new
 Priority:  normal         |  Milestone:
Component:  Developer Hub  |   Keywords:
---------------------------+-----------------
 Not sure where the code is that auto-links classes used in text, but for
 the REST API handbook, when `Requests` is used in the text (case-
 sensitively), it's linked to the Requests class.

 This is most visible in the [https://developer.wordpress.org/rest-
 api/#requests broken Requests section header] on the handbook's homepage.

 This code is in the
 [https://meta.trac.wordpress.org/browser/sites/trunk/wordpress.org/public_html
 /wp-content/themes/pub/wporg-developer/inc/formatting.php#L289
 DevHub_Formatting::autolink_references] code, but is explicitly included
 there, so this seems intentional.

 Since "requests" is both the name of the class and a common English word,
 IMO this should err on the most common case, which is as an English word.
 References to the class itself can be manually linked by the page author.

--
Ticket URL: <https://meta.trac.wordpress.org/ticket/2842>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org


More information about the wp-meta mailing list