Document the users, groups and roles model in README

examples/plugins/scheduling/plugin.ts

@@ -30,7 +30,7 @@ export default definePlugin({
     label: "Scheduling",
   }],
 
-  // Tokens this plugin introduces (docs + Keto seeding). Namespaced `<id>:<action>`.
+  // Roles this plugin introduces (docs + Keto seeding). Namespaced `<id>:<action>`.
   roles: [
     { description: "View shifts", name: READ },
     { description: "Create and edit shifts", name: WRITE },

examples/plugins/scheduling/shifts.ts

@@ -10,8 +10,8 @@ import { can, CSRF_FIELD, GuardError, type PageChrome, parseListQuery, readFormB
 
 export const SCHEDULING_PATH = "/scheduling"; // the plugin's public overview page
 export const SHIFTS_PATH = "/scheduling/shifts";
-export const READ = "scheduling:read"; // role name gating the list + nav
-export const WRITE = "scheduling:write"; // role name gating create
+export const READ = "scheduling:read"; // the role gating the list + nav
+export const WRITE = "scheduling:write"; // the role gating create
 
 export interface Shift {
   id: string;