[wp-meta] [Making WordPress.org] #5118: Introduce dev-note field to Trac

Making WordPress.org noreply at wordpress.org
Mon Jun 1 14:43:52 UTC 2020

#5118: Introduce dev-note field to Trac
 Reporter:  garrett-eclipse                         |       Owner:  (none)
     Type:  enhancement                             |      Status:  new
 Priority:  normal                                  |   Milestone:
Component:  Trac                                    |  Resolution:
 Keywords:  has-patch has-screenshots dev-feedback  |

Comment (by desrosj):

 While I do like the the idea of making the process of writing, collecting,
 and publishing dev notes easier, I am not sure this is the best way to
 accomplish that.

 IMO, this field will be reinventing the wheel. Google Docs is really the
 best way to collaborate on a document such as a post like this. There are
 revisions, comments, suggested changes, etc., and all of this works really
 well. It also creates a lot more noise within update emails. Not everyone
 that was interested in contributing to the ticket will be interested in
 contributing to the dev note.

 What if, instead of a full fledged WYSIWYG field, we just add a simple
 text field for a URL to the draft dev note on Google Docs? It solves many
 of the points brought up. It makes the process more public and
 transparent, it's easy to know who and where the draft is, who had
 participated and contributed, etc. The draft can be created and linked to
 at any point (so the primary contributor could draft it while fresh in
 their mind). It also allows contributors to follow along if they wish by
 starring the document on Google Drive.

 When the dev note is finally published, the link to the draft document can
 be replaced with the final Make/Core blog post.

 For clarity, the field should be accompanied by a description linking to
 the [https://make.wordpress.org/core/handbook/best-practices/post-comment-
 guidelines/ Post & Comment Guidelines page] in the Core handbook.

 Alternatively, if we want to avoid embracing Google Docs as an external
 means to collaborate on these posts, we could encourage using draft posts
 on Make Core for creating and refining the post. Though I don't think I
 like that because a) it requires a public preview (which expires after a
 given time frame), and b) may cause confusion if someone shares a public
 preview link and someone is not aware that the post has not officially
 been published.

 If we choose to add a URL field, we could create a report that lists all
 `needs-dev-note` tickets showing information like component, owner, and
 URL to the draft, etc. This could maybe help replace the spreadsheets that
 have been used recently.

Ticket URL: <https://meta.trac.wordpress.org/ticket/5118#comment:12>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org

More information about the wp-meta mailing list