Hi,
This thread has been hijacked by several other proposals which were not part of my initial
proposal which consisted of only 2 rules.
I’d like to progress and agree about those 2 rules **only** (for the moment). I’d like to
officially put them on
I got the following answer related to my proposal:
* Vincent: ok (obviously)
* Thomas: ok
* Gabriela: ok
Does anyone disagree with those 2 rules?
Barring any negative feedback, I’ll move them to
this
afternoon.
Then we can iterate on the rest of what was proposed in this thread:
* Data dir
* Locations for apps
Thanks
-Vincent
On 27 Sep 2015, at 21:19, vincent(a)massol.net wrote:
Hi devs,
Following our implementation of NS/NP in 7.2 I’d like to propose 2 new best practices for
app dev that we would list at
http://dev.xwiki.org/xwiki/bin/view/Community/ApplicationDevelopmentBestPra…
1) New rule 1: “Code” subspace
Current text:
* Generally, put all your pages in a single space dedicated for the application
you're developing (e.g. Faq, Scheduler, IRC, AppWithinMinutes, etc). The name must be
as short as possible while still being understandable of course and without overusing
abbreviations.
New version:
* Generally, put all your pages in a single space dedicated for the application
you're developing (e.g. Faq, Scheduler, IRC, AppWithinMinutes, etc). The name must be
as short as possible while still being understandable of course and without overusing
abbreviations.
* Technical pages should be put in a subspace named “Code”
Note: this rule can only be applied for new applications for now since the EM doesn’t
know how to follow renames currently so for example if I move pages from the FAQCode space
to the FAQ.Code space, when EM upgrades the app, it’ll display all pages in FAQCode as
deleted (basically it considers all pages in FAQ.Code as new pages and pages in FAQCode as
deleted pages). Note: I’ve created
http://jira.xwiki.org/browse/XWIKI-12622 for this.
2) New rule 2:
* Technical pages without children must be terminal pages.
WDYT?
Thanks
-Vincent