- xwiki-devs@xwiki.org - lists.xwiki.org

[xwiki-devs] Javadoc style for examples
by Vincent Massol 22 Jan '18

22 Jan '18

Hi devs, FYI I’ve started documenting our best practice for examples in javadoc at: http://dev.xwiki.org/xwiki/bin/view/Community/CodeStyle/JavaCodeStyle/#HUse… Let me know if you don’t agree or want to add more stuff to it. Thanks -Vincent

1 0

[xwiki-devs] Contribution help for GSoC 2018
by Prateek Bilung 22 Jan '18

22 Jan '18

Hi!, I am Prateek Bilung, a second-year undergraduate student at B.I.T., Mesra (India). I am new to open source community and want to contribute to this organization. I know basics of javascript, DOM manipulation and interested in the project "Translation in context". Please guide me on this. Thanks!

2 1

[xwiki-devs] [XWiki Day] BFD#162
by Alex Cotiugă 19 Jan '18

19 Jan '18

Hello devs, This Thursday is BFD#162: http://dev.xwiki.org/xwiki/bin/view/Community/XWikiDays#HBugfixingdays Our current status is: * We reached the balance between created and closed bugs for the 120 days period (0 bugs) * -86 bugs over 365 days (1 year) * -58 bugs over 500 days (between 1 and 2 years) * -241 bugs over 1600 days (4.3 years) * -686 bugs since the beginning of XWiki See https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=10352 Here's the BFD#162 dashboard to follow the progress during the day: https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13942 Happy Bug Fixing Day, Alex

1 1

[xwiki-devs] [Proposal] Replace surefire plugin by failsafe plugin for functional tests
by Vincent Massol 18 Jan '18

18 Jan '18

Hi devs, We’ve been using the surefire plugin from the beginning even for functional tests. However it would be more correct to use the failsafe plugin for functional tests since this allows to perform some actions if a test fails (like stopping XWiki - Note that right now this is not affecting us since we start/stop XWiki from Java so we’ve implemented this behavior ourselves). I need this for using the fabric8 docker plugin for ex so that if some functional test fails the docker containers will be stopped. Ok with everyone? For reference: http://maven.apache.org/surefire/maven-failsafe-plugin/ Thanks -Vincent

6 7

[xwiki-devs] [Proposal] [CodeStyle] Committing XML wiki page date changes
by Eduard Moraru 15 Jan '18

15 Jan '18

Hi devs, These are the current code style rules for committed XML wiki pages: http://dev.xwiki.org/xwiki/bin/view/Community/XWikiXMLFilesCodeStyle = Proposal 1 = I was personally not aware we had documented these practices that we had been applying since forever. It's good that we have them, but there seems to be no mention about committing changes for the "creationDate", "date" and "contentUpdateDate" fields. Part of the committers (including myself) are applying the old practice of omitting changes to the date fields when committing a change to an XML wiki page. However, since this practice is not written and agreed upon, its usage is not consistent. So, the proposal is to include the rule of not committing changes on the date fields of XML wiki pages. The rationale, AFAIR, includes: * After an upgrade, users should not see "ghost" modifications in their wiki (e.g. when sorting by date in the Page Index). This affects even more manual imports with the "as backup" option enabled. * On release, any date changes of a default translation XML page will produce N other XML page changes, for each translation of the modified page (due to the way l10n exports the translations based on the latest version of the default language of that page). * others? = Proposal 2 = Now, building on this, I would like to make a second proposal (which I don't believe deserves a separate thread): 1) Let's remove all date fields from committed XML wiki pages in our source repository 2) Let's make sure that the XAR import properly handles empty or missing date fields and falls back on the current date 3) Let's update the xar:format goal to remove the date fields (configurable, since it could they might still be needed by some content projects, etc.) 4) Let's make the build fail (xar:verify) if the XML wiki pages contain date fields (again configurable, as above) Note: All the above still depend on the first proposal of not committing date changes to XML files (which will be simplified by point 3) above). The rationale for this is that we have always wanted to fix our "dates problem", since after installation, the wiki is populated with pages created in 2009, which is extremely odd to users that have just installed XWiki. This second proposal sounds to me like a solution for that. WDYT? Thanks, Eduard

8 7

[xwiki-devs] Documentation for Job REST API is missing details
by Vincent Massol 15 Jan '18

15 Jan '18

Hi guys, I’m trying to use the Job REST API but the doc is pretty poor at http://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiR… For example to execute a job it says that you only need to pass a “jobType” described as "The type of the job to pass to the Job Executor” … errr what’s the type and what are the valid values? Would be nice to have some example too. Also it doesn’t mention any payload that I have to send but I guess I need to describe the job that I need to execute. What’s the format? It also says: “ Since 9.2RC1 jobs started trough the REST API automatically get their runtime context injected with the following REST HTTP request context properties: • current wiki • current user • request URL and parameters “ What if I want to specify the wiki, user for ex? How do I do that? At the end there are examples of file format at http://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiR… but nothing for jobs. Could someone help improve the doc so that I can try to use it? Thanks! -Vincent

2 4

[xwiki-devs] [GSOC] XWiki is applying for GSoC 2018. Proposals and mentors needed!
by Eduard Moraru 12 Jan '18

12 Jan '18

Hello fellow XWiki community members, This year XWiki is planning to participate once more at Google's Summer of Code [1]. The organization registration period has already started (January 4, 2018) and the deadline is January 23, 2018 [2] (in 1.5 weeks). 1. We need to provide by then a list of proposals and assign mentors for the students that are going to implement them. I would like to ask everybody that wants to participate as a mentor from the XWiki organization to review the proposals [3] list (when projects are being added) and add as many interesting proposals as possible. The proposals can be either new, or they can be revived from previous years. Just navigate to the previous years [4], find the proposal you like and know about, go to its proposal page (click it) and press the "Clone to this year" link. Now you can assign yourself as lead for that project, update it's description if needed and wait for the student applications to start pouring 2. We also need to submit the actual application [5] of the XWiki organization to participate to the GSoC 2018 project so I would also like to ask you to review it so that we have a better chance of being selected into the program. 3. If you feel that you would like to help on improving XWiki's GSoC guides and application forms, please find tips for students [6] on XWiki's GSoC page, the student application form [7] and the lessons learned [8] from previous years participations. Thanks for your help, Eduard ---------- [1] https://summerofcode.withgoogle.com/ [2] https://summerofcode.withgoogle.com/how-it-works/#timeline [3] http://dev.xwiki.org/xwiki/bin/view/GoogleSummerOfCode/#HProposedProjects28… [4] http://dev.xwiki.org/xwiki/bin/view/GoogleSummerOfCode/WebHome#HPreviousGSo… [5] http://dev.xwiki.org/xwiki/bin/view/GoogleSummerOfCode/OrganizationApplicat… [6] http://dev.xwiki.org/xwiki/bin/view/GoogleSummerOfCode/Guidelines [7] http://dev.xwiki.org/xwiki/bin/view/GoogleSummerOfCode/student+application+… [8] http://dev.xwiki.org/xwiki/bin/view/GoogleSummerOfCode/LessonsLearned

1 0

[xwiki-devs] [XWiki Day] BFD#161
by Alex Cotiugă 12 Jan '18

12 Jan '18

Hello devs, This Thursday is BFD#161: http://dev.xwiki.org/xwiki/bin/view/Community/XWikiDays#HBugfixingdays Our current status is: * -3 bugs over 120 days (4 months), i.e. we need to close 3 bugs to have created bugs # = closed bugs # * -74 bugs over 365 days (1 year) * -48 bugs over 500 days (between 1 and 2 years) * -242 bugs over 1600 days (4.3 years) * -688 bugs since the beginning of XWiki See https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=10352 Here's the BFD#161 dashboard to follow the progress during the day: https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13941 Happy Bug Fixing Day, Alex

1 1

[xwiki-devs] [PROPOSAL] Implement decorators in xwiki-platform-container
by Clément Aubin 09 Jan '18

09 Jan '18

Hi devs, This proposal is related to the following discussion on IRC : https://botbot.me/freenode/xwiki/2018-01-08/?msg=95495049&page=5 Abstract: We currently have an abstraction of the notion of a "container" defined in xwiki-platform-container-api [1]. This abstraction is very basic, but allows XWiki to support two different types of containers : Servlet and Portlet, and maybe support other types in the future. Problem: As those abstractions are very basic, it's quite hard to use them without downcasting them. A common example is the following: if I want to send a redirection in a Response object [2], I will need either to forge my own output that returns the correct HTTP code, with the correct header, etc … or I can downcast the given Response to all of its possible implementations and, for each implementation, find the correct method to use for sending a redirect. In order to avoid such tricks in the future, we could implement decorators that will allow Request and Response implementations to handle certain actions. In my previous example, a Response implementing RedirectResponse would expose a method `#sendRedirect(String url)`. The advantage here is that we don't really need to know on which Response implementation we are working on. WDYT ? Thanks, Clément [1] https://github.com/xwiki/xwiki-platform/tree/master/xwiki-platform-core/xwi… [2] https://github.com/xwiki/xwiki-platform/blob/master/xwiki-platform-core/xwi…

3 4

[xwiki-devs] [ANN] XWiki 9.11.1 released
by Eduard Moraru 08 Jan '18

08 Jan '18

The XWiki development team is proud to announce the availability of XWiki 9.11.1. This is a bugfix release that covers important issues that we have discovered since 9.11 has been released. You can download it here: http://www.xwiki.org/xwiki/bin/view/Main/Download Make sure to review the release notes: http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/9.11.1 Thanks for your support -The XWiki dev team

1 0