diff --git a/kwa-ui/src/stores/requirements.ts b/kwa-ui/src/stores/requirements.ts
index 92bb641..e384fe2 100644
--- a/kwa-ui/src/stores/requirements.ts
+++ b/kwa-ui/src/stores/requirements.ts
@@ -5,24 +5,24 @@ export type RequirementStatus = 'Draft' | 'In Review' | 'Approved' | 'Blocked' |
 export type RequirementPriority = 'Low' | 'Medium' | 'High' | 'Critical'
 
 export interface Requirement {
-  id: number
-  reference: string
-  uuid: string
-  title: string
-  status: RequirementStatus
-  priority: RequirementPriority
-  owner: string
-  progress: number
-  dueDate: string
-  description: string
-  rationale: string
-  acceptanceCriteria: string[]
-  impactedModules: string[]
-  blockers: string[]
-  notes: string
-  stakeholders: string[]
-  flexibility: string
-  tolerances: string
+  id: number                            // Internal identifier, not exposed to users
+  reference: string                     // User-facing reference code (e.g., "REQ-101") 
+  uuid: string                          // Unique identifier for traceability
+  title: string                         // Short, descriptive title of the requirement
+  description: string                   // Detailed description of the requirement
+  status: RequirementStatus             // Current lifecycle status of the requirement
+  priority: RequirementPriority         // Business priority level for implementation
+  owner: string                         // Person responsible for the requirement
+  progress: number                      // Completion percentage of the requirement
+  dueDate: string                       // Expected completion date
+  rationale: string                     // Reasoning behind the requirement       
+  acceptanceCriteria: string[]          // List of conditions that must be met for acceptance
+  impactedModules: string[]             // List of application modules affected by this requirement
+  blockers: string[]                    // List of issues preventing progress on this requirement
+  notes: string                         // Additional information or comments about the requirement
+  stakeholders: string[]                // List of individuals or groups with an interest in the requirement
+  flexibility: string                   // Degree of flexibility in requirement implementation (e.g., "Low", "Medium", "High")
+  tolerances: string                    // Acceptable limits for deviations from the requirement (e.g., "Maximum 5% of requirements can have incomplete artifact links")
 }
 
 export const useRequirementsStore = defineStore('requirements', () => {