while I’m quite happy that since XWiki 17.4.0, there is a UI for setting the required rights of a page, unfortunately it turns out that users or even other developers don’t understand the wording in the UI. As a minimum requirement for an improved version, users should be able to understand that a page that enforces a right is a page containing scripts even without fully understanding required rights. I’ve created a design page to document the current wording, from what I consider the most important to improve to the least important.
I would like to invite everybody to contribute ideas how to improve the wording, either here in this thread or directly on the design page (by adding sections with the improved wording in the respective section). I’ll try collecting everything from this forum thread in the design page (any help with that is of course also welcome). As a second step, we’ll then ask people who haven’t been involved in this discussion how/if they understand the different proposed formulations. Of course, you can also express your support for certain formulations in this forum thread. Depending on the result, I might open another proposal to decide which formulation we use in the end.
Thank you very much for your contributions!
PS: I’m not contributing any formulations for now, you can consider the current status as my proposal as these texts were mostly written by me.
Hi @MichaelHamann, thank you for creating the design page with the wording!
I added a section with proposed improvements, please tell me what you think about it.
In general, I think we should:
Consider replacing “rights” with “permissions” (applicable to all XWiki access rights, could need its own proposal, but I think that it should be discussed more broadly with a global revamping of user management and rights management)
Replace “enforce” by a word more user-friendly, like “apply” or “protect”
So -1 from me FTM. I also don’t see any explanation why Permissions would be better than Rights. As you said, if we want to change to Permissions we’ll need a specific proposal and it’s a large amount of work. What’s sure is that we need full consistency in the UI.
Completely agree, and yes this change should be made only if we make it everywhere.
From what I saw in other tools, permissions and roles are more commonly used than rights, but indeed it’s not the place to discuss it, I’ll suggest it when we discuss the revamp of Rights.
On another note, I don’t think that the fact something is documented in the documentation is a valid argument to not do wording improvements in the UI.
I updated my wording proposals to switch back to “rights”.
