We don’t have any clear rules about using “document” vs. “page” when naming APIs and configuration properties. While implementing https://jira.xwiki.org/browse/XWIKI-17447 I realized that I could use either of:
Same for the configuration property itself:
edit.document.inplaceEditing.enabled = true edit.page.inplaceEditing.enabled = true
I know we agreed at some point to use “page” in the UI, when “talking” to the user, but I don’t recall any decision about the API / configuration level.
First of all, do you see any conceptual difference between page and document? Now that we have page references, for me a document and a page represents the same concept in the XWiki model.
If both represent the same concept, then which term do we deprecate on the long term? “document”?
If they are different concepts, then I guess we’ll keep them both on the long term, but then when do we use one versus the other? And don’t you find this confusing for the user / developer? They have to understand 2 concepts that are very close.
My view is that at the level of XWiki model they represent the same concept and that on the long term we’ll move away from document to page. Do you share the same view?