[wp-meta] [Making WordPress.org] #1905: Improve organization of the user contributed note submission area

[Making WordPress.org]

#1905: Improve organization of the user contributed note submission area
---------------------------------------+------------------
 Reporter:  DrewAPicture               |       Owner:
     Type:  defect                     |      Status:  new
 Priority:  normal                     |   Milestone:
Component:  Developer Hub              |  Resolution:
 Keywords:  has-patch has-screenshots  |
---------------------------------------+------------------

Comment (by DrewAPicture):

 Replying to [comment:1 kevinwhoffman]:
 > @DrewAPicture Great stuff. I agree moving the preview under the editor
 makes sense. I also like how some notes set the stage for the editing
 process, but I actually think all of the notes with the exception of the
 GFDL notice should be before the editor because they impact the subject
 matter and manner in which the note is written.

 The intent for leaving the spam, accessibility, and GDFL notices ''below''
 the form was actually to place them directly ''above'' the submission
 button. The accessibility notice (tabbing out of the textarea) really
 should just be an `aria-describedby` field for the textarea.

 > As an alternative approach, have you considered populating the editor
 itself with placeholder text that communicates these notes while also
 demonstrating some of the shortcode usage? Doing so would alleviate the
 need for a separate bulleted list and cut down on the overall height of
 the section while giving the user a better idea of how the editor can be
 used.

 Yes and no. What actually goes in the box is subjective, and while it
 certainly trends toward examples, we get all kinds of things submitted
 through there. I do think we could make the preview a little more
 intelligent actually. Do a simple regex for common JS and/or PHP and if
 the syntax tags are missing make the suggestion to add them.

 I also think we could conceivably hide the preview box before anything is
 entered, or even go with a tabbed interface like
 GitHub[https://cl.ly/3A1R043q433U/Screen%20Shot%202016-08-14%20at%2010.25.35%20PM.png
 [1]] and
 O2[https://cl.ly/2L393P1k1C3J/Screen%20Shot%202016-08-14%20at%2010.24.49%20PM.png
 [2]] use.

--
Ticket URL: <https://meta.trac.wordpress.org/ticket/1905#comment:2>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org