Moodle
  1. Moodle
  2. MDL-12801

Improve terminology in 'Assign global roles'

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Major 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
    • Rank:
      30798

      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.

        Issue Links

          Activity

          Hide
          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
          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
          Martin Dougiamas added a comment -

          Thanks, I'm onto it.

          Show
          Martin Dougiamas added a comment - Thanks, I'm onto it.
          Hide
          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
          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 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 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
          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
          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
          Nicolas Martignoni added a comment -

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

          Closing.

          Show
          Nicolas Martignoni added a comment - This is fixed on 1.9b4. And in fr_utf8 (and other languages) too Closing.
          Hide
          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
          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: