Wiki source code of Release Notes for XWiki 8.0 Release Candidate 1
Version 18.1 by Thomas Mortagne on 2016/03/03
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
| 7 | <insert description of release here> | ||
| 8 | |||
| 9 | = New and Noteworthy (since XWiki 8.0 Milestone 2) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for 8.0>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13593]]. | ||
| 12 | |||
| 13 | == New XWiki distribution == | ||
| 14 | |||
| 15 | The work on a new as small as possible distribution of XWiki has started. The key goal is to try to have a WAR as small as small as possible on which you install one of the Flavors automatically found in the registered repositories (meaning http://extensions.xwiki.org/ for now). | ||
| 16 | |||
| 17 | The size is still not very far from XE (188M compared to the 219M XE), one important limitation is that we kept some old plugins because they are hard to install as extensions (you need to modify xwiki.cfg and restart). We need to convert them to proper components so that we can move them to contrib as "pure" extensions. | ||
| 18 | |||
| 19 | There is still two important know limitation in that version that we hope to have in 8.0 final or 8.1 at worst: | ||
| 20 | * make flavors search in the Distribution Wizard asynchronous, the step is blocker for a long time right now which is not very nice | ||
| 21 | * support upgrade of invalid flavor (search for a valid replacement in that case) | ||
| 22 | |||
| 23 | It's still experimental and should be avoided in production but the move has started and we are very excited by the new opportunity this will bring ! | ||
| 24 | |||
| 25 | == Custom admin user to replace standard Admin user == | ||
| 26 | |||
| 27 | Since XWiki exist you got a user ##Admin## with password ##admin## in the default XAR. This time is now gone and you are now asked to register your own user which will be the owner of the wiki (meaning whatever you do you can't loose admin right on it, unless you change the owner) when you install XWiki from scratch. We kept a standard ##Admin## user for the all in one jetty/hsqldb package so the change won't be visible in this one. | ||
| 28 | |||
| 29 | {{image reference="customuser.png"/}} | ||
| 30 | |||
| 31 | == Auto generated main wiki descriptor == | ||
| 32 | |||
| 33 | The XE XAR does not contain any descriptor for the main wiki anymore. This descriptor is now automatically created/updated at start and associated to the domain name found in the URL that was used to access the wiki the first time. | ||
| 34 | |||
| 35 | == Chart Macro Additions == | ||
| 36 | |||
| 37 | There are several new parameters that can now be set when using the [[Chart Macro>>extensions:Extension.Chart Macro]]: | ||
| 38 | |||
| 39 | |=Parameter name|=Default value|=Description | ||
| 40 | |##backgroundColor##|Grey background|Background color of the non-chart area, specified using an hexadecimal notation, e.g. ##FFAACC## (first 2 letters are for Red, following 2 are for Green and last 2 are for Blue). | ||
| 41 | |##plotBackgroundColor##|White|Background color of the plot area, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 42 | |##plotBorderColor##|Black|Color of the plot border, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 43 | |##borderColor##|Black|Color of the outer graph border, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 44 | |##legendBackgroundColor##|White|Background color of the legend box, specified using an hexadecimal notation (see ##backgroundColor##). | ||
| 45 | |##plotBorderVisible##|true|Whether the border for the plot area is visible or not. Valid values are ##true## and ##false##. | ||
| 46 | |##legendVisible##|true|Whether the legend is displayed or not. Valid values are ##true## and ##false##. | ||
| 47 | |||
| 48 | Examples: | ||
| 49 | |||
| 50 | * Pie chart with no legend displayed, no border, no title and white background:((( | ||
| 51 | {{code}} | ||
| 52 | {{chart type="pie" source="inline" params="range:B2-D5;series:columns;backgroundColor:FFFFFF;plotBackgroundColor:FFFFFF;plotBorderVisible:false;legendVisible:false" width="320" height="240"}} | ||
| 53 | |=|=X|=Y|=Z | ||
| 54 | |Q1|1.2|3.4|1.3 | ||
| 55 | |Q2|4.5|3.4|2.3 | ||
| 56 | |Q3|1.2|4.5|9.0 | ||
| 57 | |Q4|3.4|1.2|1.2 | ||
| 58 | {{/chart}} | ||
| 59 | {{/code}} | ||
| 60 | |||
| 61 | {{image reference="pieChartWhite.png"/}} | ||
| 62 | ))) | ||
| 63 | * Colored background:((( | ||
| 64 | {{code}} | ||
| 65 | {{chart type="pie" source="inline" params="range:B2-D5;series:columns;backgroundColor:FFFF11;plotBackgroundColor:11FFFF" title="Chart Test" width="320" height="240"}} | ||
| 66 | |=|=X|=Y|=Z | ||
| 67 | |Q1|1.2|3.4|1.3 | ||
| 68 | |Q2|4.5|3.4|2.3 | ||
| 69 | |Q3|1.2|4.5|9.0 | ||
| 70 | |Q4|3.4|1.2|1.2 | ||
| 71 | {{/chart}} | ||
| 72 | {{/code}} | ||
| 73 | |||
| 74 | {{image reference="pieChartColor.png"/}} | ||
| 75 | ))) | ||
| 76 | |||
| 77 | In addition, it's now possible to perform [[advanced customization of the generated chart>>extensions:Extension.Chart Macro||anchor="HAdvancedCustomization"]]. | ||
| 78 | |||
| 79 | == Rename and Copy UI == | ||
| 80 | |||
| 81 | * Updated the rename page UI's field labels and descriptions to mention that the update links also updates the relative links inside the renamed page and not just the backlinks. Also moved the count displays from the field label to the field's description, where applicable, in both the rename and the copy UI, for better UI consistency.((( | ||
| 82 | {{image reference="renameRewording-Step1.png"/}} | ||
| 83 | |||
| 84 | {{image reference="copyRewording-Step1.png"/}} | ||
| 85 | ))) | ||
| 86 | * The copy and rename UI now have the children and links options checked by default. We believe it`s better to preserve data consistency by default, even with the cost o having to go through lengthy operations (like when renaming a document with many children). | ||
| 87 | |||
| 88 | == Miscellaneous == | ||
| 89 | |||
| 90 | <insert misc user stuff and important bug fix descriptions here in a list, when they are too small to warrant a section by themselves - Change the version in the URL below!> | ||
| 91 | |||
| 92 | See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%228.0-rc-1%22&tempMax=1000]] fixed in this release. | ||
| 93 | |||
| 94 | = For Developers = | ||
| 95 | |||
| 96 | == <developer feature N> == | ||
| 97 | |||
| 98 | <description of developer feature N> | ||
| 99 | |||
| 100 | == Deprecated and Retired projects == | ||
| 101 | |||
| 102 | <description of deprecated and retired projects> | ||
| 103 | |||
| 104 | == Upgrades == | ||
| 105 | |||
| 106 | The following dependencies have been upgraded: | ||
| 107 | |||
| 108 | * [[Pygments 2.1.1>>http://jira.xwiki.org/browse/XWIKI-13019]] | ||
| 109 | * [[org.eclipse.sisu.plexus 0.3.3>>https://jira.xwiki.org/browse/XCOMMONS-920]] | ||
| 110 | * [[Tika 1.12>>http://jira.xwiki.org/browse/XWIKI-13104]] | ||
| 111 | * [[Groovy 2.4.6>>http://jira.xwiki.org/browse/XCOMMONS-918]] | ||
| 112 | * [[JGroups 3.6.8>>http://jira.xwiki.org/browse/XWIKI-13146]] | ||
| 113 | * [[httpclient 4.5.2>>http://jira.xwiki.org/browse/XCOMMONS-924]] | ||
| 114 | * [[slf4j 1.7.18>>http://jira.xwiki.org/browse/XCOMMONS-925]] | ||
| 115 | * [[Jackson 2.7.2>>http://jira.xwiki.org/browse/XCOMMONS-926]] | ||
| 116 | * [[logback 1.1.6>>http://jira.xwiki.org/browse/XCOMMONS-927]] | ||
| 117 | |||
| 118 | == Miscellaneous == | ||
| 119 | |||
| 120 | * Developers can now enable the [[CSS Source Maps feature in the LESS Module>>extensions:Extension.LESS Module||anchor="HDebuggingLESSfileswithCSSSourceMaps"]], to help the CSS debugging. | ||
| 121 | |||
| 122 | = Translations = | ||
| 123 | |||
| 124 | The following translations have been updated: | ||
| 125 | |||
| 126 | {{language codes="none, none"/}} | ||
| 127 | |||
| 128 | = Tested Browsers & Databases = | ||
| 129 | |||
| 130 | {{warning}} | ||
| 131 | The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon. | ||
| 132 | {{/warning}} | ||
| 133 | |||
| 134 | {{comment}} | ||
| 135 | TODO: uncomment and update with proper link when the report is ready. | ||
| 136 | {{include reference="TestReports.ManualTestReportTemplateSummary"/}} | ||
| 137 | {{/comment}} | ||
| 138 | |||
| 139 | = Performances tests compared to <last super stable version> = | ||
| 140 | |||
| 141 | <a summary of the comparison with latest super stable version> | ||
| 142 | |||
| 143 | More details on <link to the test report>. | ||
| 144 | |||
| 145 | = Known issues = | ||
| 146 | |||
| 147 | * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]] | ||
| 148 | |||
| 149 | = Backward Compatibility and Migration Notes = | ||
| 150 | |||
| 151 | == General Notes == | ||
| 152 | |||
| 153 | When upgrading make sure you compare your ##xwiki.cfg##, ##xwiki.properties## and ##web.xml## files with the newest version since some configuration parameters may have been modified or added. Note that you should add ##xwiki.store.migration=1## so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything. | ||
| 154 | |||
| 155 | == Issues specific to XWiki 8.0 Release Candidate 1 == | ||
| 156 | |||
| 157 | <issues specific to the project> | ||
| 158 | |||
| 159 | == API Breakages == | ||
| 160 | |||
| 161 | The following APIs were modified since XWiki 8.0 Milestone 2: | ||
| 162 | |||
| 163 | {{code language="none"}} | ||
| 164 | <clirr output here> | ||
| 165 | {{/code}} |
