Changes for page Migration Guide to Nested Pages

Summary

• Page properties (2 modified, 0 added, 0 removed)
• Objects (1 modified, 0 added, 0 removed)
  • XWiki.XWikiComments[0]

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.VincentMassol
	1	+XWiki.gdelhumeau

Content

...	...	@@ -1,5 +1,19 @@
1	1	{{toc /}}
2	2
	3	+= A bit of history =
	4	+
	5	+Before the introduction of the Nested Pages concept (in 7.2), the content in a wiki was organized like this:
	6	+* we had some **Spaces**, that you can see as "folder"
	7	+* inside these spaces, we had **Pages**, where you were able to write some texts or store applications entries.
	8	+
	9	+In that time, we cannot have spaces inside spaces, so all pages were placed inside a one-level space. The pages were identified like this: ##NameOfTheSpace.NameOfThePage##.
	10	+
	11	+Some pages were a bit special. They were the "home" page of a space. Every time a user wanted to reach a space without specifying a precise page name, she was redirected to that space home page. These pages were called "WebHome" (because at the very beginning of XWiki, "spaces" were called "web").
	12	+
	13	+== Parent/Child relationship ==
	14	+
	15	+The user was able to specify a **parent** page for each page she had created. This parent could have been any page, for example the page ##Movies.ItsAWonderfulLife## could have ##Directors.FrankCapra##. Then ##ItsAWonderfulLife## was listed as ##Child## of ##FrankCapra##.
	16	+
3	3	= Principle =
4	4
5	5	After having upgrade the XWiki instance to a recent version (7.4+), you should convert your existing pages to nested ones. This will permit:

XWiki.XWikiComments[0]

Comment

...	...	@@ -1,2 +1,7 @@
1	1	Ideas:
2		-* Replace SpaceDocs and Spaces Panels with Navigation, Silbings and Children Panels.
	2	+* Replace SpaceDocs and Spaces Panels with Navigation, Siblings and Children Panels.
	3	+* Some existing code may break slightly and needs to be adapted: code taking some user input and creating Spaces based on that will most likely display {{{"\."}}}, {{{"\:"}}} and {{{"\\"}}} in the UI. Unless the code already cleans the user input and removes ".", ":" and "\" characters. So for example if a user enter a Space name of "my.space":
	4	+** before 7.2: the code would create/display a Space named "my.space"
	5	+** after 7.2: the code will create/display a Space named "my\.space"
	6	+* Various XWiki API that used to return a space name have been returning a space reference string (i.e. list of spaces separated by dots and escaped {{{"\."}}}, {{{"\:"}}} and {{{"\\"}}} characters). Code using those API may need to be updated. See [[XWiki 7.2 release notes>>xwiki:ReleaseNotes.ReleaseNotesXWiki72||anchor="HSpaceReferenceinsteadofSpacename"]] for more details (this content could be copied in a section of the migration guide).
	7	+

Date

...	...	@@ -1,1 +1,1 @@
1		-2016-02-15 15:30:08.808
	1	+2016-02-15 15:30:08.0