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

On 22 Aug 2016, at 11:20, Vincent Massol <vincent(a)massol.net> wrote: 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/RecommendedExtensionsSelect… 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/RecommendedExtensionsSelect… Thanks -Vincent > On 18 Aug 2016, at 21:00, Vincent Massol <vincent(a)massol.net> wrote: > > 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/RecommendedExtensi… > * 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 recommended so far: http://extensions.xwiki.org/xwiki/bin/view/ExtensionCode/RecommendedExtensi… > * I’m hesitating for the following extensions. Specifically I need to know what their authors think and whether they’re ok to support them actively. I also don’t know them enough to know of their quality. Feel free to comment on them. > > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Recent+Blog+Entries+Ma… ? > - http://extensions.xwiki.org/xwiki/bin/view/Extension/SunkenFlamingoTheme/ > - http://extensions.xwiki.org/xwiki/bin/view/Extension/RtForm/ > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Realtime+Netflux+Front… > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Realtime+Netflux+Backe… > - http://extensions.xwiki.org/xwiki/bin/view/Extension/XQuiz/ > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Condition+Macro/ > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Suggest+LiveTable+Filt… > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Let%27s+Encrypt+suppor… > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Derzelas+Script+Runner/ > - http://extensions.xwiki.org/xwiki/bin/view/Extension/XCarousel/ > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Wiki+Analyzer+Applicat… > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Event+Listeners+Admini… > - 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/ZoneEdit+Macro > - http://extensions.xwiki.org/xwiki/bin/view/Extension/SVG+Rasterizing+API > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Trusted+Headers+Authen… > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Trusted+authentication… > - http://extensions.xwiki.org/xwiki/bin/view/Extension/Mail+address+encryptor > - http://extensions.xwiki.org/xwiki/bin/view/Extension/XWikiTube > - http://extensions.xwiki.org/xwiki/bin/view/Extension/XFF+Maven+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 <vincent(a)massol.net> 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 at >> http://markmail.org/message/cr5edm27qcag6n3q >> >> I’m starting the work. >> >> Thanks >> -Vincent >> >> >>> On 23 May 2016, at 10:39, Vincent Massol <vincent(a)massol.net> 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 updated for a long time and are doing old and deprecated ways of doing things such as not providing an entry in the Applications Panel for example, they’re not just polished, etc) and this causes frustrations for our users. Note that this also reflects on the overall quality of the XWiki project and product. >>> >>> 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. This is not fully successful so far because we don’t have enough people voting and because those ratings are not used to display/filter extensions on the Extensions LT or inside XWiki in the EM UI. So we need to continue this 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 becomes 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 process of hand-selecting the best extensions and marking them as recommended. The idea would be to list recommended extensions first on the e.x.o home page, in the EM UI in XWiki and even in extension search results. In the EM UI, an idea would also be to have a new “Recommended Extensions” filter in addition to the existing filters (core extensions, installed extensions, 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 committed in 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 “Recommended”, ie. validating that it’s done correctly. XWiki core committers have the authorization to unset an app that was marked a recommended by a community member. >>> * We wouldn’t offer a simple way in the UI to mark an extension as recommended since we don’t want everyone who has an account on xwiki.org to start marking apps as recommended. OTOH we want to allow 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, we can 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 to avoid conflict of opinions (although there’s always the possibility in 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/ApplicationDevelopmentBestPra…. 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 xwiki syntax 2.0+. >>> >>> WDYT? >>> >>> I’m willing to help do the work and mark extensions as recommended. >>> >>> Thanks >>> -Vincent