[xwiki-devs] [Proposal] Deprecating SpaceDocs and Spaces panels

Hi devs, I’ve implemented http://jira.xwiki.org/browse/XWIKI-12599 and as part of this issue I needed to handle the SpaceDocs Panel, and we also need to handle the Spaces panel. Here’s my proposal: * In general we should list only Panels that work for the Nested Pages (NP) mode in the Panel Wizard (i.e. not show any Panels containing the word “Space” in their title or content). The rationale is that the majority of uses of XWiki will be for NP. * We should continue to provide Panels that work for the Nested Spaces (NS) mode (e.g. SpaceDocs, Spaces), but as extensions on e.x.o and not bundled by default in XE * However we shouldn’t break existing XWiki instances and thus I’m proposing this: ** Deprecate the SpaceDocs and Spaces panels by displaying a message (when the user is Admin), trying to push the move to the newer Panels (Children, Siblings and Navigation panels). For example, this is what I’ve done for SpaceDocs: https://www.evernote.com/l/AHfvmKs-DSZBh4IJf1Wp7VV5JfK2pEmfgME Note that this allows Admins to see that message in the Panel Wizard too and thus not be tempted to use them. ** Keep the deprecated Panels for 1 full cycle (i.e. remove them in XWiki 9.0, i.e. move them to xwiki-contrib at that time). Basically a similar strategy than for young apis. WDYT? Thanks -Vincent