Skip to Content
Last modified by Ilie Andriuta on 2026/02/09 16:31
Show last authors
1 {{velocity}}
2 #if ($doc.getValue('released') != 1)
3 {{warning}}This version has not yet been released.{{/warning}}
4 #end
5 {{/velocity}}
6
7 {{velocity}}
8 #set ($rnObject = $doc.getObject('ReleaseNotes.Code.ReleaseNoteClass'))
9 #set ($product = $rnObject.product)
10 #set ($version = $rnObject.version)
11 #set ($versionPrefix = $stringtool.substringBefore($version, '-'))
12 #set ($versionParts = $stringtool.split($versionPrefix, '.'))
13 #set ($isRC = $version.contains('rc'))
14 #set ($isFinal = !$isRC)
15 #set ($isFirstFinal = $isFinal && ($versionParts.size() == 2 || $versionParts[2] == 0))
16 #set ($isBugFix = $isFinal && $versionParts.size() == 3 && $versionParts[2] > 0)
17 {{/velocity}}
18
19 {{box cssClass="floatinginfobox" title="**Contents**"}}
20 {{toc/}}
21 {{/box}}
22
23 This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]. They share the same release notes as they are released together and have the same version.
24
25 This is a bug fix releases which, among other thing, also improves usage of undo / redo capability in realtime editing. This is also the first Long Term Support version of the 17.10.x branch that will be supported for a full cycle.
26
27 {{velocity}}
28 {{jiraBlockersFor version="$version" id="xwikiorg"/}}
29 {{/velocity}}
30
31 = New and Noteworthy (since {{velocity}}$product{{/velocity}} 17.10.1) =
32
33 [[Full list of issues fixed and Dashboard for 17.10.2>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=16511]].
34
35 {{jira style="list" url="https://jira.xwiki.org" fields="type, status, key, summary" source="jql"}}
36 resolution in (Fixed, "Solved By") AND component != "Development Issues only" AND component != "Development Issues only - Test" AND component != "Dependency Upgrades" AND project in (XCOMMONS, XRENDERING, XWIKI) AND fixVersion in (17.10.2)
37 {{/jira}}
38
39 {{releasenotechanges/}}
40
41 = Upgrades =
42
43 The following runtime dependencies have been upgraded (they have a different release cycle than [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]):
44
45 {{velocity}}
46 #if ($isFirstFinal)
47 #set ($affectedVersions = "${version}-rc-1, ${version}")
48 #else
49 #set ($affectedVersions = "${version}")
50 #end
51 {{jira url="https://jira.xwiki.org" source="jql" style="list"}}
52 project in (XWIKI, XCOMMONS, XRENDERING) AND issuetype = Task AND fixVersion in ($affectedVersions) AND component = "Dependency Upgrades"
53 {{/jira}}
54 {{/velocity}}
55
56 = Translations =
57
58 The following translations have been updated:
59
60 {{language codes="de,fr,ko,uk,zh_TW"}}{{/language}}
61
62 = Tested Browsers & Databases =
63
64 == Automated testing ==
65
66 XWiki executes a lot of [[automated tests during its build>>dev:Community.Testing.WebHome||anchor="HTestingStrategy"]], testing all [[supported configurations>>dev:Community.SupportStrategy.WebHome]]. In addition, some manual QA is also executed to try to discover additional problems (see below):
67
68 {{include reference="TestReports.ManualTestReportSummaryXWiki17102.WebHome"/}}
69
70 **NOTE**: This XWki version has been [[manually tested>>dev:Community.ManualTestStrategy]] by the QA and has been validated.
71
72 {{comment}}
73 TODO: uncomment and update with proper links when the report is ready.
74
75 = Performances tests compared to <last super stable version> =
76
77 {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}}
78
79 More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]].
80 {{/comment}}
81
82 = Security Issues =
83
84 Security issues are not listed in issue lists or dashboards to avoid disclosing ways to use them, but they will appear automatically in them once they're disclosed. See the [[XWiki Security Policy>>dev:Community.SecurityPolicy.WebHome]] for more details.
85
86 = Known issues =
87
88 * [[Bugs we know about>>https://jira.xwiki.org/issues/?jql=category%20%3D%2010000%20AND%20issuetype%20%3D%20Bug%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20updated%20DESC]]
89
90 = Backward Compatibility and Migration Notes =
91
92 == General Notes ==
93
94 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
95 ** ##xwiki.cfg##
96 ** ##xwiki.properties##
97 ** ##web.xml##
98 ** ##hibernate.cfg.xml##
99 * Add ##xwiki.store.migration=1## in ##xwiki.cfg## so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.
100
101 == API Breakages ==
102
103 The following APIs were modified since {{velocity}}$product{{/velocity}} 17.10.1:
104
105 {{velocity}}
106 {{backwardCompatibilityReport134 version="$version"/}}
107 {{/velocity}}
108
109 = Credits =
110
111 The following people have contributed code and translations to this release (sorted alphabetically):
112
113 * 이경철
114 * Cédric LAMBLIN
115 * LucasC
116 * Marius Dumitru Florea
117 * Michael Hamann
118 * Nikita Petrenko
119 * Simon Urli
120 * Simpel
121 * Thomas Mortagne
122 * xrichard
123 * 龔敖摩

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected