Wiki source code of Release Notes for XWiki 16.6.0
Last modified by Ilie Andriuta on 2024/08/19
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{velocity}} | ||
| 2 | #set ($rnObject = $doc.getObject('ReleaseNotes.Code.ReleaseNoteClass')) | ||
| 3 | #set ($product = $rnObject.product) | ||
| 4 | #set ($version = $rnObject.version) | ||
| 5 | #set ($versionPrefix = $stringtool.substringBefore($version, '-')) | ||
| 6 | #set ($versionParts = $stringtool.split($versionPrefix, '.')) | ||
| 7 | #set ($isRC = $version.contains('rc')) | ||
| 8 | #set ($isFinal = !$isRC) | ||
| 9 | #set ($isFirstFinal = $versionParts.size() == 2 && $isFinal) | ||
| 10 | {{/velocity}} | ||
| 11 | |||
| 12 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 13 | {{toc/}} | ||
| 14 | {{/box}} | ||
| 15 | |||
| 16 | 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. | ||
| 17 | |||
| 18 | This release contains a few improvments like better display of icons in object and class editors, or the capability to request the effective author for developpers, but has been mostly focused on bug fixing, including security fixes. | ||
| 19 | |||
| 20 | {{comment}} | ||
| 21 | Uncomment when there's at least one issue listed in the table! | ||
| 22 | {{error}} | ||
| 23 | The following regressions were introduced in this release (and found after it was released). Please check them out and if they impact you we recommend waiting to upgrade to a version where they are fixed. | ||
| 24 | |||
| 25 | {{velocity}} | ||
| 26 | #if ($isFirstFinal) | ||
| 27 | #set ($affectedVersions = "${version}-rc-1, ${version}") | ||
| 28 | #set ($fixVersionJQL = " and (fixVersion != ${version}-rc-1 or fixVersion is empty)") | ||
| 29 | #else | ||
| 30 | #set ($affectedVersions = "${version}") | ||
| 31 | #set ($fixVersionJQL = "") | ||
| 32 | #end | ||
| 33 | {{jira id="xwikiorg" source="jql"}} | ||
| 34 | category = 10000 and affectedVersion in ($affectedVersions)${fixVersionJQL}and priority = Blocker and resolution in (Fixed, Unresolved) and component != "Development Issues only" | ||
| 35 | {{/jira}} | ||
| 36 | {{/velocity}} | ||
| 37 | {{/error}} | ||
| 38 | {{/comment}} | ||
| 39 | |||
| 40 | = New and Noteworthy (since {{velocity}}$product{{/velocity}} 16.5.0) = | ||
| 41 | |||
| 42 | [[Full list of issues fixed and Dashboard for XWiki 16.6.0>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=15795]]. | ||
| 43 | |||
| 44 | {{releasenotechanges/}} | ||
| 45 | |||
| 46 | === Upgrades === | ||
| 47 | |||
| 48 | 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]]): | ||
| 49 | |||
| 50 | * [[dompurify 3.1.5>>https://jira.xwiki.org/browse/XWIKI-22273]] | ||
| 51 | * [[Elastic search client 8.14.3>>https://jira.xwiki.org/browse/XWIKI-22331]] | ||
| 52 | * [[jsoup 1.18.1>>https://jira.xwiki.org/browse/XWIKI-22330]] | ||
| 53 | * [[Docker Java 3.4.0>>https://jira.xwiki.org/browse/XWIKI-22329]] | ||
| 54 | * [[MySQL connector 9.0.0>>https://jira.xwiki.org/browse/XWIKI-22307]] | ||
| 55 | * [[PrettyTime 5.0.9>>https://jira.xwiki.org/browse/XWIKI-22305]] | ||
| 56 | * [[XML-DTD 4.3>>https://jira.xwiki.org/browse/XWIKI-22299]] | ||
| 57 | * [[Commons Codec 1.17.1>>https://jira.xwiki.org/browse/XCOMMONS-3093]] | ||
| 58 | * [[Jackson 2.17.2>>https://jira.xwiki.org/browse/XCOMMONS-3092]] | ||
| 59 | * [[Maven Resolver to 1.9.21>>https://jira.xwiki.org/browse/XCOMMONS-3091]] | ||
| 60 | * [[bytebuddy 1.14.18>>https://jira.xwiki.org/browse/XCOMMONS-3090]] | ||
| 61 | * [[JGroups 5.3.9>>https://jira.xwiki.org/browse/XCOMMONS-3089]] | ||
| 62 | * [[Plexus Archiver 4.10.0>>https://jira.xwiki.org/browse/XCOMMONS-3086]] | ||
| 63 | * [[httpcore 5.2.5>>https://jira.xwiki.org/browse/XCOMMONS-3085]] | ||
| 64 | * [[Checker Qual 3.45.0>>https://jira.xwiki.org/browse/XCOMMONS-3081]] | ||
| 65 | * [[Groovy 4.0.22>>https://jira.xwiki.org/browse/XCOMMONS-3078]] | ||
| 66 | * [[Woodstox 7.0.0>>https://jira.xwiki.org/browse/XCOMMONS-3070]] | ||
| 67 | * [[Maven to 3.9.8>>https://jira.xwiki.org/browse/XCOMMONS-3062]] | ||
| 68 | * [[Syntax Highlighting 4.8>>https://jira.xwiki.org/browse/XWIKI-22338]] | ||
| 69 | |||
| 70 | * [[Moved back to JSON-Java (instead of Open JSON) and upgrade to 20240303>>https://jira.xwiki.org/browse/XCOMMONS-3087]] | ||
| 71 | |||
| 72 | = Translations = | ||
| 73 | |||
| 74 | The following translations have been updated: | ||
| 75 | |||
| 76 | {{language codes="de, zh"/}} | ||
| 77 | |||
| 78 | = Tested Browsers & Databases = | ||
| 79 | |||
| 80 | == Automated testing == | ||
| 81 | |||
| 82 | 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): | ||
| 83 | |||
| 84 | {{include reference="TestReports.ManualTestReportSummaryXWiki1660.WebHome"/}} | ||
| 85 | |||
| 86 | {{comment}} | ||
| 87 | TODO: uncomment and update with proper links when the report is ready. | ||
| 88 | |||
| 89 | = Performances tests compared to <last super stable version> = | ||
| 90 | |||
| 91 | {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}} | ||
| 92 | |||
| 93 | More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]]. | ||
| 94 | {{/comment}} | ||
| 95 | |||
| 96 | = Security Issues = | ||
| 97 | |||
| 98 | 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. | ||
| 99 | |||
| 100 | = Accessibility = | ||
| 101 | |||
| 102 | We are working towards [[WCAG 2.1>>https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG]] level AA compliance. | ||
| 103 | |||
| 104 | Current status: | ||
| 105 | |||
| 106 | * A total of **354878** automated tests are run. | ||
| 107 | * **99.50%** of our automated WCAG tests are passing. There are **347** warnings left in the tests to fix (0.10%) and **1414** incomplete tests (0.40%), i.e. they need manual validation. | ||
| 108 | ** Note that the automated WCAG tests have 2 limitations: WCAG tests are executed only for UIs for which we have automated functional tests available, and the underlying library we use for testing (Axe Core) estimates that it catches only about 50% of WCAG issues. In the future we plan to also run manual WCAG tests once we've fixed all the issues we can catch automatically. | ||
| 109 | ** Out of the *61* rules automatically tested on XWiki, only *4* of them return warnings. All the other tests will fail the build if violated in the future. | ||
| 110 | * Remaining accessibility violations can be seen on this [[filter result table>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=15396#Filter-Results/20051]]. | ||
| 111 | * The progress of fixing accessibility issues vs raising them can be seen on this [[status chart>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=15396#Created-vs-Resolved-Chart/20019]]. | ||
| 112 | |||
| 113 | = Known issues = | ||
| 114 | |||
| 115 | * [[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]] | ||
| 116 | |||
| 117 | = Backward Compatibility and Migration Notes = | ||
| 118 | |||
| 119 | == General Notes == | ||
| 120 | |||
| 121 | * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added: | ||
| 122 | ** ##xwiki.cfg## | ||
| 123 | ** ##xwiki.properties## | ||
| 124 | ** ##web.xml## | ||
| 125 | ** ##hibernate.cfg.xml## | ||
| 126 | * 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. | ||
| 127 | |||
| 128 | == API Breakages == | ||
| 129 | |||
| 130 | The following APIs were modified since {{velocity}}$product{{/velocity}} 16.5.0: | ||
| 131 | |||
| 132 | {{velocity}} | ||
| 133 | {{backwardCompatibilityReport134 version="$version"/}} | ||
| 134 | {{/velocity}} | ||
| 135 | |||
| 136 | = Credits = | ||
| 137 | |||
| 138 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 139 | |||
| 140 | * Alex Cotiugă | ||
| 141 | * Antoine Mottier | ||
| 142 | * Dorian OUAKLI | ||
| 143 | * LucasC | ||
| 144 | * Manuel Leduc | ||
| 145 | * Mariana Batista | ||
| 146 | * Marius Dumitru Florea | ||
| 147 | * Michael Hamann | ||
| 148 | * Oana-Lavinia Florean | ||
| 149 | * Pierre Jeanjean | ||
| 150 | * Simon Urli | ||
| 151 | * Simpel | ||
| 152 | * Thomas Mortagne | ||
| 153 | * Vincent Massol | ||
| 154 | * xingya1822 | ||
| 155 | * Ümit Solmaz |
