diff --git a/backend/src/lib/api-docs/constants.ts b/backend/src/lib/api-docs/constants.ts
index 7aa0b24cf..92b3b9e01 100644
--- a/backend/src/lib/api-docs/constants.ts
+++ b/backend/src/lib/api-docs/constants.ts
@@ -722,14 +722,14 @@ export const AUDIT_LOG_STREAMS = {
 
 export const PROJECT_ROLE = {
   CREATE: {
-    projectSlug: "The slug of the project to create role.",
+    projectSlug: "Slug of the project to create the role for.",
     slug: "The slug of the role.",
     name: "The name of the role.",
     description: "The description for the role.",
     permissions: "The permissions assigned to the role."
   },
   UPDATE: {
-    projectSlug: "The slug of the project to update role.",
+    projectSlug: "Slug of the project to update the role for.",
     roleId: "The ID of the role to update",
     slug: "The slug of the role.",
     name: "The name of the role.",
@@ -737,7 +737,7 @@ export const PROJECT_ROLE = {
     permissions: "The permissions assigned to the role."
   },
   DELETE: {
-    projectSlug: "The slug of the project to delete role.",
+    projectSlug: "Slug of the project to delete the role for.",
     roleId: "The ID of the role to update"
   },
   GET_ROLE_BY_SLUG: {
@@ -745,6 +745,6 @@ export const PROJECT_ROLE = {
     roleSlug: "The slug of the role to get details"
   },
   LIST: {
-    projectSlug: "The slug of the project to list roles."
+    projectSlug: "The slug of the project to list the roles for."
   }
 };
diff --git a/backend/src/services/project-role/project-role-service.ts b/backend/src/services/project-role/project-role-service.ts
index 5a50c4a44..ffd446fad 100644
--- a/backend/src/services/project-role/project-role-service.ts
+++ b/backend/src/services/project-role/project-role-service.ts
@@ -45,7 +45,7 @@ const getPredefinedRoles = (projectId: string, roleFilter?: ProjectMembershipRol
       name: "Admin",
       slug: ProjectMembershipRole.Admin,
       permissions: projectAdminPermissions,
-      description: "Complete administration access over the project",
+      description: "Full administrative access over a project",
       createdAt: new Date(),
       updatedAt: new Date()
     },
@@ -55,7 +55,7 @@ const getPredefinedRoles = (projectId: string, roleFilter?: ProjectMembershipRol
       name: "Developer",
       slug: ProjectMembershipRole.Member,
       permissions: projectMemberPermissions,
-      description: "Non-administrative role in an project",
+      description: "Limited read/write role in a project",
       createdAt: new Date(),
       updatedAt: new Date()
     },
@@ -65,7 +65,7 @@ const getPredefinedRoles = (projectId: string, roleFilter?: ProjectMembershipRol
       name: "Viewer",
       slug: ProjectMembershipRole.Viewer,
       permissions: projectViewerPermission,
-      description: "Non-administrative role in an project",
+      description: "Only read role in a project",
       createdAt: new Date(),
       updatedAt: new Date()
     },