[xwiki-devs] [Proposal] Consider Wiki Syntax to be advanced and working in the Nested Spaces paradigm
Hi devs, I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t agree about it anymore :) We’d like to propose that when the user edits a document using the wiki editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes) and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space concept, only create WebHome documents unless he’s an advanced user). The rationale for this is that a lot of macros accept a reference parameter and I don’t think we should change them to support hiding “WebHome” and do an automatic redirect. That would be too complex. In addition, if you use a script macro, then you’ll also see WebHome mentions. Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter displayer for Reference-type parameters to display a tree, so that the non-technical doesn’t have to enter “WebHome”. WDYT? Thanks -Vincent
Hi, I'd like to make sure I'm understanding things correctly before commenting further. Please see below. On Wed, Jul 29, 2015 at 5:09 PM, vincent@massol.net <vincent@massol.net> wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes) and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space concept, only create WebHome documents unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's "A.B.C.WebHome") and I want to create "D". What would happen with your proposal is this: - In WYSIWYG mode, I'll create a link to a new page called "D" and it will automatically create a link to "A.B.C.D.WebHome" - In Wiki mode, several possibilities: - I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new terminal document) - I create a link to [[A.B.C.D]] (new terminal document) - I create a link to [[A.B.C.D.WebHome]] (new nested space) Is my understanding correct? Thanks, Guillaume
The rationale for this is that a lot of macros accept a reference parameter and I don’t think we should change them to support hiding “WebHome” and do an automatic redirect. That would be too complex. In addition, if you use a script macro, then you’ll also see WebHome mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter displayer for Reference-type parameters to display a tree, so that the non-technical doesn’t have to enter “WebHome”.
WDYT?
Thanks -Vincent
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
Hi Guillaume, On 30 Jul 2015 at 15:57:21, Guillaume Lerouge (guillaume@xwiki.com(mailto:guillaume@xwiki.com)) wrote:
Hi,
I'd like to make sure I'm understanding things correctly before commenting further. Please see below.
On Wed, Jul 29, 2015 at 5:09 PM, vincent@massol.net wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes) and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space concept, only create WebHome documents unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's "A.B.C.WebHome") and I want to create "D". What would happen with your proposal is this:
- In WYSIWYG mode, I'll create a link to a new page called "D" and it will automatically create a link to “A.B.C.D.WebHome"
correct
- In Wiki mode, several possibilities: - I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new terminal document)
Almost. I’ll create a page [[D]] in the current space.
- I create a link to [[A.B.C.D]] (new terminal document)
correct
- I create a link to [[A.B.C.D.WebHome]] (new nested space)
correct
Is my understanding correct?
yes. Please take into account the fact that there are plenty of macros that accept a reference as input (include macro, display macro, context macro, etc). When used in WYSIWYG we would use some special displayer to let the user user a tree to select the document but in wiki mode, the idea of the proposal is to let the user fill the exact reference (including WebHome). Thanks -Vincent
Thanks,
Guillaume
The rationale for this is that a lot of macros accept a reference parameter and I don’t think we should change them to support hiding “WebHome” and do an automatic redirect. That would be too complex. In addition, if you use a script macro, then you’ll also see WebHome mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter displayer for Reference-type parameters to display a tree, so that the non-technical doesn’t have to enter “WebHome”.
WDYT?
Thanks -Vincent
Yep, it goes along the lines of what we are doing with displaying Nested Documents in the UI (view mode + wysiwyg and maybe inline for edit mode), but doing Nested Spaces in the platform (java, actions other than view, wiki syntax edit mode, etc.). And it also has the added bonus of allowing us to preserve our sanity :) Thanks, Eduard On Thu, Jul 30, 2015 at 5:20 PM, vincent@massol.net <vincent@massol.net> wrote:
Hi Guillaume,
On 30 Jul 2015 at 15:57:21, Guillaume Lerouge (guillaume@xwiki.com(mailto: guillaume@xwiki.com)) wrote:
Hi,
I'd like to make sure I'm understanding things correctly before commenting further. Please see below.
On Wed, Jul 29, 2015 at 5:09 PM, vincent@massol.net wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes) and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space concept, only create WebHome documents unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's "A.B.C.WebHome") and I want to create "D". What would happen with your proposal is this:
- In WYSIWYG mode, I'll create a link to a new page called "D" and it will automatically create a link to “A.B.C.D.WebHome"
correct
- In Wiki mode, several possibilities: - I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new terminal document)
Almost. I’ll create a page [[D]] in the current space.
- I create a link to [[A.B.C.D]] (new terminal document)
correct
- I create a link to [[A.B.C.D.WebHome]] (new nested space)
correct
Is my understanding correct?
yes. Please take into account the fact that there are plenty of macros that accept a reference as input (include macro, display macro, context macro, etc). When used in WYSIWYG we would use some special displayer to let the user user a tree to select the document but in wiki mode, the idea of the proposal is to let the user fill the exact reference (including WebHome).
Thanks -Vincent
Thanks,
Guillaume
The rationale for this is that a lot of macros accept a reference parameter and I don’t think we should change them to support hiding “WebHome” and do an automatic redirect. That would be too complex. In addition, if you use a script macro, then you’ll also see WebHome mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter displayer for Reference-type parameters to display a tree, so that the non-technical doesn’t have to enter “WebHome”.
WDYT?
Thanks -Vincent
devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
Hi, see below. On Thu, Jul 30, 2015 at 4:38 PM, Eduard Moraru <enygma2002@gmail.com> wrote:
Yep, it goes along the lines of what we are doing with displaying Nested Documents in the UI (view mode + wysiwyg and maybe inline for edit mode), but doing Nested Spaces in the platform (java, actions other than view, wiki syntax edit mode, etc.).
And it also has the added bonus of allowing us to preserve our sanity :)
Indeed :-) Thanks,
Eduard
On Thu, Jul 30, 2015 at 5:20 PM, vincent@massol.net <vincent@massol.net> wrote:
Hi Guillaume,
On 30 Jul 2015 at 15:57:21, Guillaume Lerouge (guillaume@xwiki.com (mailto: guillaume@xwiki.com)) wrote:
Hi,
I'd like to make sure I'm understanding things correctly before commenting further. Please see below.
On Wed, Jul 29, 2015 at 5:09 PM, vincent@massol.net wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 <https://mailtrack.io/trace/link/c2e95277c8709891c3d945a49529d8627406d6f9?url=http%3A%2F%2Fjira.xwiki.org%2Fbrowse%2FXWIKI-12304&signature=4434606d9f0c3a83> entitled "Make wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes) and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space concept, only create WebHome documents unless he’s an advanced user).
Let's take an example. Say I'm on page .../A/B/C/ (so that's "A.B.C.WebHome") and I want to create "D". What would happen with your proposal is this:
- In WYSIWYG mode, I'll create a link to a new page called "D" and it will automatically create a link to “A.B.C.D.WebHome"
correct
- In Wiki mode, several possibilities: - I create a link to [[D]] => it becomes a link to [[A.B.C.D]] (new terminal document)
Almost. I’ll create a page [[D]] in the current space.
And [[D]] will be a terminal document in that space (that was my main question).
- I create a link to [[A.B.C.D]] (new terminal document)
correct
- I create a link to [[A.B.C.D.WebHome]] (new nested space)
correct
Is my understanding correct?
yes. Please take into account the fact that there are plenty of macros that accept a reference as input (include macro, display macro, context macro, etc). When used in WYSIWYG we would use some special displayer to let the user user a tree to select the document but in wiki mode, the idea of the proposal is to let the user fill the exact reference (including WebHome).
I understand the rationale and I agree it's probably the best course of action, though it hurts the "clean & consistent" part of my brain a bit... But anyway, short of rewriting the model I'm not sure what else we could do. In other words I'd be +0, were I to have a binding vote (which I did use to have in the not-so-long-ago past!). Thanks, Guillaume
Thanks -Vincent
Thanks,
Guillaume
The rationale for this is that a lot of macros accept a reference parameter and I don’t think we should change them to support hiding “WebHome” and do an automatic redirect. That would be too complex. In addition, if you use a script macro, then you’ll also see WebHome mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter displayer for Reference-type parameters to display a tree, so that the non-technical doesn’t have to enter “WebHome”.
WDYT?
Thanks -Vincent
devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs <https://mailtrack.io/trace/link/b6f3c9c8621f0e0805fbfd3ee3112a233db2b112?url=http%3A%2F%2Flists.xwiki.org%2Fmailman%2Flistinfo%2Fdevs&signature=4e2f8e346f2a8c65>
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs <https://mailtrack.io/trace/link/b6f3c9c8621f0e0805fbfd3ee3112a233db2b112?url=http%3A%2F%2Flists.xwiki.org%2Fmailman%2Flistinfo%2Fdevs&signature=4e2f8e346f2a8c65>
Hi guys, Could I have more opinions on this? Thanks -Vincent On 29 Jul 2015 at 17:09:23, vincent@massol.net (vincent@massol.net) wrote: Hi devs, I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t agree about it anymore :) We’d like to propose that when the user edits a document using the wiki editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes) and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space concept, only create WebHome documents unless he’s an advanced user). The rationale for this is that a lot of macros accept a reference parameter and I don’t think we should change them to support hiding “WebHome” and do an automatic redirect. That would be too complex. In addition, if you use a script macro, then you’ll also see WebHome mentions. Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter displayer for Reference-type parameters to display a tree, so that the non-technical doesn’t have to enter “WebHome”. WDYT? Thanks -Vincent
+1 Thanks, Marius On Mon, Aug 24, 2015 at 5:11 PM, vincent@massol.net <vincent@massol.net> wrote:
Hi guys,
Could I have more opinions on this?
Thanks -Vincent
On 29 Jul 2015 at 17:09:23, vincent@massol.net (vincent@massol.net) wrote:
Hi devs,
I had created JIRA issue http://jira.xwiki.org/browse/XWIKI-12304 entitled "Make wanted wiki links create Nested Documents” but I’ve brainstormed with Edy and we don’t agree about it anymore :)
We’d like to propose that when the user edits a document using the wiki editor then he’s using the Nested Spaces paradigm (and thus uses “WebHome” to create links to Space homes) and when he edits using the WYSIWYG editor he uses the Nested Document paradigm (no Space concept, only create WebHome documents unless he’s an advanced user).
The rationale for this is that a lot of macros accept a reference parameter and I don’t think we should change them to support hiding “WebHome” and do an automatic redirect. That would be too complex. In addition, if you use a script macro, then you’ll also see WebHome mentions.
Note that when editing a macro in WYSIWYG editor we’ll need to have a macro parameter displayer for Reference-type parameters to display a tree, so that the non-technical doesn’t have to enter “WebHome”.
WDYT?
Thanks -Vincent
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
participants (4)
-
Eduard Moraru -
Guillaume Lerouge -
Marius Dumitru Florea -
vincent＠massol.net