Uploaded image for project: 'Moodle'
  1. Moodle
  2. MDL-12801

Improve terminology in 'Assign global roles'

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 1.9
    • Fix Version/s: 1.8.4, 1.9, 2.0
    • Component/s: Roles / Access
    • Labels:
      None
    • Affected Branches:
      MOODLE_19_STABLE
    • Fixed Branches:
      MOODLE_18_STABLE, MOODLE_19_STABLE, MOODLE_20_STABLE

      Description

      According to docs.moodle.org article "Assign roles" the outermost context is known as the System context. It is confusing to see this context referred to in the Moodle user interface variously as "Global" and "Core system." The user interface terminology needs to be brought in line with the documentation.

      I would suggest the following changes:

      (1) change the link

      :::: Site administration -> Users -> Permissions -> Assign Global roles

      to

      :::: Site administration -> Users -> Permissions -> Assign System roles

      (2) change the heading

      :::: Assign roles in Core system

      to

      :::: Assign System roles

      (3) Review the help files linked to from the top of this page. They still treat Site and System as if they were the same thing.

        Gliffy Diagrams

          Issue Links

            Activity

            Hide
            stronk7 Eloy Lafuente (stronk7) added a comment -

            Agree 100%. Assigning to MD to distribute it plus raising to Major because those names are important IMO.

            Show
            stronk7 Eloy Lafuente (stronk7) added a comment - Agree 100%. Assigning to MD to distribute it plus raising to Major because those names are important IMO.
            Hide
            dougiamas Martin Dougiamas added a comment -

            Thanks, I'm onto it.

            Show
            dougiamas Martin Dougiamas added a comment - Thanks, I'm onto it.
            Hide
            dougiamas Martin Dougiamas added a comment -

            I've gone with those changes in 1.8, 1.9 and 2.0. Everything should refer to "System" now. Thanks!

            Show
            dougiamas Martin Dougiamas added a comment - I've gone with those changes in 1.8, 1.9 and 2.0. Everything should refer to "System" now. Thanks!
            Hide
            ray Ray Lawrence added a comment -

            I wish I seen this earlier.... the change implies the role assignment applies to the system context. Role assignments here may span many more (or all) contexts depending upon the capabilities that make up the role.

            I agree that there needs to be a consistent naming convention. I regret to say that I don't think this change helps as the word "system" is now being used to mean two different things i.e. a single context and "across the entire site".

            Show
            ray Ray Lawrence added a comment - I wish I seen this earlier.... the change implies the role assignment applies to the system context. Role assignments here may span many more (or all) contexts depending upon the capabilities that make up the role. I agree that there needs to be a consistent naming convention. I regret to say that I don't think this change helps as the word "system" is now being used to mean two different things i.e. a single context and "across the entire site".
            Hide
            jisner John Isner added a comment -

            Ray, System is indeed a "single context," but because it is the highest level context, it contains ALL the other contexts (Front page, course, user, etc.). If you are assigned a role in the System context, you will have that role wherever you go, regardless of the "capabilities that make up the role."

            This fix simply eliminates the confusing synonyms (global, core system) in favor of a single consistent term "System."

            Is it the ideal name? I don't think so. The ideal name would be Site. However "Site" was hijacked in 1.8 to mean the Front page context, despite the commonly accepted meaning of the term site (google "Moodle site" and you will get 82,900 hits and none of them refer to the Site context!!!). The Moodle UI has mostly undone the damage by changing Site to Front page, but the documentation still refers to Site context. I created MDL-12960 against the documentation to make the documentation consistent with the UI. Once that's done, System could reasonably be changed to Site, bringing us full circle

            Show
            jisner John Isner added a comment - Ray, System is indeed a "single context," but because it is the highest level context, it contains ALL the other contexts (Front page, course, user, etc.). If you are assigned a role in the System context, you will have that role wherever you go, regardless of the "capabilities that make up the role." This fix simply eliminates the confusing synonyms (global, core system) in favor of a single consistent term "System." Is it the ideal name? I don't think so. The ideal name would be Site. However "Site" was hijacked in 1.8 to mean the Front page context, despite the commonly accepted meaning of the term site (google "Moodle site" and you will get 82,900 hits and none of them refer to the Site context!!!). The Moodle UI has mostly undone the damage by changing Site to Front page, but the documentation still refers to Site context. I created MDL-12960 against the documentation to make the documentation consistent with the UI. Once that's done, System could reasonably be changed to Site, bringing us full circle
            Hide
            mina Nicolas Martignoni added a comment -

            This is fixed on 1.9b4. And in fr_utf8 (and other languages) too

            Closing.

            Show
            mina Nicolas Martignoni added a comment - This is fixed on 1.9b4. And in fr_utf8 (and other languages) too Closing.
            Hide
            dougiamas Martin Dougiamas added a comment - - edited

            Just about the use of "Site" the code and developer docs have always referred to the "Front page" as the "Site course", that's where that came from. It was changed TO "Front page" to make it less confusing.

            Show
            dougiamas Martin Dougiamas added a comment - - edited Just about the use of "Site" the code and developer docs have always referred to the "Front page" as the "Site course", that's where that came from. It was changed TO "Front page" to make it less confusing.

              People

              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved:
                  Fix Release Date:
                  11/Jan/08