Le jeu. 27 sept. 2018 à 16:16, Alex Cotiugă <[email protected]> a écrit :
> On Thu, Sep 27, 2018 at 5:04 PM Vincent Massol <[email protected]> wrote: > > > Hi devs, > > > > I’ve just had a quick chat with Edy and I found that we had a difference > > of opinion on the Code subspace practice. > > > > On > > > https://dev.xwiki.org/xwiki/bin/view/Community/ApplicationDevelopmentBestPractices > > we say: > > "Technical pages must be put in a subspace named Code” > > > > Now Edy says that this should be done only for data-generating apps. > > > > This sounds to me like an exception from a rule. Time has taught us that > nothing is unchangeable and we can expect at some point to have some > content in a non-data-generating app. > I would prefer to keep the current rule. > I agree. > > > > It’s not my recollection that this rule was only for this case and this > is > > what I’d like to discuss here. > > > > For example, I’ve noticed that ActiveInstalls has all technical pages > > under ActiveInstalls, see > > > > > https://github.com/xwiki/xwiki-platform/tree/053f0a2757cea18a5916632a58c6046ba61954cd/xwiki-platform-core/xwiki-platform-activeinstalls/xwiki-platform-activeinstalls-server/xwiki-platform-activeinstalls-server-ui/src/main/resources/ActiveInstalls > > > > I would fix it to have only the WebHome remain under ActiveInstalls and > > move all the technical pages under ActiveInstalls.Code. > > > > The only case where it could make sense to not have a Code subspace would > > be when the app has no UI at all. Even in this case, you might argue that > > we should always have a home to provide a description about the content > of > > the space. > > > > So right now I’m personally in favor of continuing the rule we defined in > > the best practices: > > "Technical pages must be put in a subspace named Code” > > > > WDYT? > > > > Thanks > > -Vincent > > > > Thanks, > Alex > -- Guillaume Delhumeau ([email protected]) Research & Development Engineer at XWiki SAS Committer on the XWiki.org project
