Change Details

== Background The community provided feedback for one of the APIs we provide. (From https://meta.wikimedia.org/w/index.php?title=Talk:MoreMenu&oldid=26506053#c-Xover-20240329161100-Jdlrobson-20240324141900 and T359110 there is some confusion around the addPortlet API.) == User story As a community gadget developer I want a better understanding of how the addPortlet API works. == Requirements [] Fix the documentation for the before argument ("selector of the element preceding the new portlet" should presumably be "selector of the element the new portlet should precede"). I've tried adding some docs about the dropdown use case at #Dropdowns (Vector-only) [x] Document the skin specific behaviours relating to dropdown [] Consider (with other engineers) providing further abstractions that specifically create a dropdown (where supported) == Communication criteria - does this need an announcement or discussion? [] The addPortlet API should be announced in Tech News given we have evidence it is now useful.

== Background The community provided feedback for one of the APIs we provide. (From https://meta.wikimedia.org/w/index.php?title=Talk:MoreMenu&oldid=26506053#c-Xover-20240329161100-Jdlrobson-20240324141900 and T359110 there is some confusion around the addPortlet API.) == User story As a community gadget developer I want a better understanding of how the addPortlet API works. == Requirements [] Fix the documentation for the before argument ("selector of the element preceding the new portlet" should presumably be "selector of the element the new portlet should precede"). I've tried adding some docs about the dropdown use case at #Dropdowns (Vector-only) [x] Document the skin specific behaviours relating to dropdown [] Consider (with other engineers) providing further abstractions that specifically create a dropdown (where supported) == Communication criteria - does this need an announcement or discussion? [] The addPortlet API should be announced in Tech News given we have evidence it is now useful. [T365661]

== Background The community provided feedback for one of the APIs we provide. (From https://meta.wikimedia.org/w/index.php?title=Talk:MoreMenu&oldid=26506053#c-Xover-20240329161100-Jdlrobson-20240324141900 and T359110 there is some confusion around the addPortlet API.) == User story As a community gadget developer I want a better understanding of how the addPortlet API works. == Requirements [] Fix the documentation for the before argument ("selector of the element preceding the new portlet" should presumably be "selector of the element the new portlet should precede"). I've tried adding some docs about the dropdown use case at #Dropdowns (Vector-only) [x] Document the skin specific behaviours relating to dropdown [] Consider (with other engineers) providing further abstractions that specifically create a dropdown (where supported) == Communication criteria - does this need an announcement or discussion? [] The addPortlet API should be announced in Tech News given we have evidence it is now useful. [T365661]