Re: [xwiki-devs] [Proposal] Curation process for extensions on e.x.o

On 29 Aug 2016, at 17:29, Ecaterina Moraru (Valica) <valicac(a)gmail.com>

should "ratings" or "active installs" be part of the Recommended

Thanks, Caty On Mon, Aug 29, 2016 at 6:27 PM, Ecaterina Moraru (Valica) < valicac(a)gmail.com&gt; wrote: > One difference between Recommended and Supported could be that "it's > demonstrating an advanced use case build on top of XWiki and user's > installing it could see the power/benefits of XWiki". Unfortunately even > this "definition" is subjective. > > So my big problem is that I don't really understand how to say if an > extension is recommended or not, and how this status is > evolving/deprecating a particular extension over time. > > Thanks, > Caty > > On Mon, Aug 29, 2016 at 6:17 PM, Ecaterina Moraru (Valica) < > valicac(a)gmail.com&gt; wrote: > >> How does an extensions looses it's "Recommended" status? >> >> Thanks, >> Caty >> >> On Mon, Aug 29, 2016 at 6:16 PM, Ecaterina Moraru (Valica) < >> valicac(a)gmail.com&gt; wrote: >> >>> "Not a core Extension (i.e. not bundled by default in the base XWiki >>> Distribution)" >>> >>> extensions.xwiki.org/xwiki/bin/view/Extension/Templates+Application/

>>> bundled >>> extensions.xwiki.org/xwiki/bin/view/Extension/Tour+Application is >>> bundled >>> extensions.xwiki.org/xwiki/bin/view/Extension/CKEditor+Integration is >>> bundled >>> >>> I find http://extensions.xwiki.org/xwiki/bin/view/Extension/Notes+A >>> pplication to be not very complex. >>> >>> Missing: >>> - Blog (which is currently bundled) >>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Flash+m >>> essages+application >>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/

>>> was also interesting >>> - what about Repository app? >>> >>> Do we also provide a way for users to filter what apps are bundled

>>> maybe implicitely supported/recommended)? >>> What about extensions that have "XWiki Development Team" as author?

>>> they implicitly supported/recommended? Is there a way to filter and

>>> what they are? >>> What is the difference between supported and recommended? Is it >>> documented somewhere? Should the users care about this difference?

>>> the answers are found above in the thread, but I don't remember any >>> conclusion) >>> >>> "Don't recommend extensions that are installed as dependencies of

>>> recommended extensions, unless there are end-user use cases for using

>>> directly." >>> This means we don't support the apps dependencies? And in this

>>> we have some macros: fullcalendar, pdfviewer, etc. >>> >>> Thanks, >>> Caty >>> >>> On Mon, Aug 29, 2016 at 5:44 PM, Vincent Massol &lt;vincent(a)massol.net&gt; >>> wrote: >>> >>>> Latest news: >>>> >>>> * I’ve finished reviewing all extensions on e.x.o >>>> * The list of extensions that I consider recommended (there are 26 as >>>> of now) is available at http://extensions.xwiki.org/xw >>>> iki/bin/view/ExtensionCode/RecommendedExtensions/ >>>> * There are some extensions that I don’t know well enough to know if >>>> they could be recommended (not sure if they have active support, how

>>>> they work on latest XE, etc): http://design.xwiki.org/xwiki/ >>>> bin/view/Proposal/RecommendedExtensionsSelection >>>> >>>> To @Extension creators: please review the list and let me know if you >>>> have some extensions that you’d like recommended (make sure to check

>>>> criteria defined at http://design.xwiki.org/xwiki/ >>>> bin/view/Proposal/RecommendedExtensionsSelection). >>>> >>>> Next steps: >>>> * Modify the extension sheet to visually see when an extension is >>>> recommended >>>> * Modify the e.x.o home page to highlight Recommended Extension (see >>>> http://markmail.org/message/cr5edm27qcag6n3q ) >>>> * Modify EM to add the notion of Recommended >>>> * Merge back the new Recommended field in the Repository Application >>>> >>>> Thanks >>>> -Vincent >>>> >>>>> On 22 Aug 2016, at 11:20, Vincent Massol &lt;vincent(a)massol.net&gt;

>>>>> >>>>> I’ve started a wiki page to track which extensions we’re not sure >>>> about (whether they should be recommended or not): >>>>> http://design.xwiki.org/xwiki/bin/view/Proposal/RecommendedE >>>> xtensionsSelection >>>>> >>>>> Please edit it if you have opinion/knowledge about them (or reply on >>>> this thread and I’ll do the syncing). >>>>> >>>>> Note that for an app to be recommended it must follow the rules >>>> defined on >>>>> http://design.xwiki.org/xwiki/bin/view/Proposal/RecommendedE >>>> xtensionsSelection#HWhatisaRecommendedExtension >>>>> >>>>> Thanks >>>>> -Vincent >>>>> >>>>>> On 18 Aug 2016, at 21:00, Vincent Massol &lt;vincent(a)massol.net&gt;

>>>>>> >>>>>> ok I’ve started. >>>>>> >>>>>> 3 things: >>>>>> >>>>>> * I’ve started defining what we mean by a recommended app, see >>>> http://extensions.xwiki.org/xwiki/bin/view/ExtensionCode/Rec >>>> ommendedExtensions/ >>>>>> * I’ve processed the first 2 pages of the LT on the home page of >>>> e.x.o. (ie the first 60 extensions) and I’ve marked 11 as

>>>> far: http://extensions.xwiki.org/xwiki/bin/view/ExtensionCode/Rec >>>> ommendedExtensions/ >>>>>> * I’m hesitating for the following extensions. Specifically I need >>>> to know what their authors think and whether they’re ok to support

>>>> actively. I also don’t know them enough to know of their quality.

>>>> to comment on them. >>>>>> >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Recent+ >>>> Blog+Entries+Macros/ ? >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/SunkenF >>>> lamingoTheme/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/RtForm/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Realtim >>>> e+Netflux+Frontend/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Realtim >>>> e+Netflux+Backend/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/XQuiz/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Conditi >>>> on+Macro/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Suggest >>>> +LiveTable+Filter+Macro/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Let%27s >>>> +Encrypt+support/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Derzela >>>> s+Script+Runner/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/XCarousel/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Wiki+An >>>> alyzer+Application/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Event+L >>>> isteners+Administration/ >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Filter+ >>>> Script+API Note: we will expose the filter app, should we also expose >>>> the API? >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/ZoneEdi >>>> t+Macro >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/SVG+Ras >>>> terizing+API >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Trusted >>>> +Headers+Authentication+Adapter >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Trusted >>>> +authentication+framework >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Mail+ad >>>> dress+encryptor >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/XWikiTube >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/XFF+Mav >>>> en+Plugin Note: wrong author!!! >>>>>> - http://extensions.xwiki.org/xwiki/bin/view/Extension/Rights+ >>>> UI+Simplifier >>>>>> >>>>>> Thanks >>>>>> -Vincent >>>>>> >>>>>> The result is here: >>>>>> >>>>>>> On 18 Aug 2016, at 19:36, Vincent Massol &lt;vincent(a)massol.net&gt; >>>> wrote: >>>>>>> >>>>>>> I’m starting the work on this. BTW several of you have replied >>>> about EM but this mail was only for “e.x.o” FTM (see the subject). >>>>>>> >>>>>>> The idea is to implement something similar to what Caty proposed

>>>>>>> http://markmail.org/message/cr5edm27qcag6n3q >>>>>>> >>>>>>> I’m starting the work. >>>>>>> >>>>>>> Thanks >>>>>>> -Vincent >>>>>>> >>>>>>> >>>>>>>> On 23 May 2016, at 10:39, Vincent Massol &lt;vincent(a)massol.net&gt; >>>> wrote: >>>>>>>> >>>>>>>> Hi devs, >>>>>>>> >>>>>>>> We have a lot of entries on extensions.xwiki.org (869 as of >>>> today) and this causes some problems for our users: >>>>>>>> >>>>>>>> P1) A lot of them are not of good quality (they don’t work with >>>> the latest versions, they are complex to use, they’ve not been

>>>> a long time and are doing old and deprecated ways of doing things

>>>> not providing an entry in the Applications Panel for example,

>>>> just polished, etc) and this causes frustrations for our users. Note

>>>> this also reflects on the overall quality of the XWiki project and

>>>>>>>> >>>>>>>> P2) It’s hard for users to locate good extensions among the rest. >>>>>>>> >>>>>>>> We’ve started addressing P1) by introducing ratings on e.x.o.

>>>> is not fully successful so far because we don’t have enough people

>>>> and because those ratings are not used to display/filter extensions

>>>> Extensions LT or inside XWiki in the EM UI. So we need to continue

>>>> effort. >>>>>>>> >>>>>>>> Note that this proposal is not addressing non-extensions such as >>>> snippets which we’ll need to move elsewhere at some point but that

>>>> less important with the proposal below. >>>>>>>> >>>>>>>> Proposal >>>>>>>> ======= >>>>>>>> >>>>>>>> I’d like to propose an additional strategy that, IMO, is better >>>> suited for the size of our community: curation. Curation is the

>>>> hand-selecting the best extensions and marking them as recommended.

>>>> idea would be to list recommended extensions first on the e.x.o home

>>>> in the EM UI in XWiki and even in extension search results. In the

>>>> an idea would also be to have a new “Recommended Extensions” filter

>>>> addition to the existing filters (core extensions, installed

>>>> etc) and that would be the default filter on the “Add Extensions” UI. >>>>>>>> >>>>>>>> I propose to add a “Recommended” xproperty in the Repository app >>>> for that. We can decide whether we want this just for e.x.o or

>>>> the Repository app in xwiki-platform. >>>>>>>> >>>>>>>> Then we need to decide about the curation process: >>>>>>>> >>>>>>>> * The XWiki core committers are in charge (i.e. have the >>>> responsibility) of monitoring the apps that are marked

>>>> validating that it’s done correctly. XWiki core committers have the >>>> authorization to unset an app that was marked a recommended by a

>>>> member. >>>>>>>> * We wouldn’t offer a simple way in the UI to mark an extension

>>>> recommended since we don’t want everyone who has an account on >>>> xwiki.org to start marking apps as recommended. OTOH we want to

>>>> people from the xwiki community to help out. So the way to mark an >>>> extension as recommended would be to use the object editor (for now,

>>>> define a better implementation mechanism later on). >>>>>>>> * We define some basic rules that extensions need to follow at >>>> minimum to be accepted as recommended. These will be our guidelines

>>>> avoid conflict of opinions (although there’s always the possibility

>>>> which case it’s resolved through a vote): >>>>>>>> - Need to work on LTS + latest XWiki version (ie. ATM that would >>>> be 7.4.x and 8.1) >>>>>>>> - Need to present a polished aspect and be easily usable >>>>>>>> - Need to follow most of the best practices defined on >>>> http://dev.xwiki.org/xwiki/bin/view/Community/ApplicationDev >>>> elopmentBestPractices. Some important examples: technical pages are >>>> hidden, extension is registered in the app bar when it makes sense, >>>> extension is internationalized (if it makes sense), pages are in

>>>> syntax 2.0+. >>>>>>>> >>>>>>>> WDYT? >>>>>>>> >>>>>>>> I’m willing to help do the work and mark extensions as

_______________________________________________ devs mailing list devs(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs