[wp-trac] [WordPress Trac] #51156: Create developer documentation for disclosures.json

WordPress Trac noreply at wordpress.org
Mon Sep 7 07:21:10 UTC 2020

#51156: Create developer documentation for disclosures.json
 Reporter:  carike       |       Owner:  (none)
     Type:  enhancement  |      Status:  new
 Priority:  normal       |   Milestone:  5.6
Component:  Privacy      |     Version:  trunk
 Severity:  normal       |  Resolution:
 Keywords:  close        |     Focuses:  docs, template, privacy

Comment (by azaozz):

 Replying to [comment:9 carike]:
 > This ticket deals with the template / format plugin developers need to
 use in their individual plugin / theme (disclosures.json).
 > Basically, this ticket is meant for the people who want the digest
 version of what they need to do in their plugin / theme and do not want to
 actively participate in determining what Core does with that information
 and how.

 Right, exactly :)

 Trac is for making changes and additions to WP core, usually code but also
 inline docs (for functions), unit tests, etc.

 Developer documentation "lives" on the wp.org website. In this case the
 proper place is https://developer.wordpress.org/plugins/. Adding content
 and making changes there ids the "job" of the WP Docs team.

 I agree in this case the docs are quite harder to write and get right, and
 input from multiple people/sources is needed. To facilitate collaboration
 it seems best to use Github (as it allows inline comments, multiple
 changes, etc.), then (perhaps) link the PR to this ticket.

 Then, after the docs are deemed ready, the Docs team can review them and
 include them in the WP Plugin Developer Handbook.

Ticket URL: <https://core.trac.wordpress.org/ticket/51156#comment:10>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform

More information about the wp-trac mailing list