diff --git a/ColourMeOKGame/Assets/Scripts/Colorimetry.cs b/ColourMeOKGame/Assets/Scripts/Colorimetry.cs
index f6c585e..e006397 100644
--- a/ColourMeOKGame/Assets/Scripts/Colorimetry.cs
+++ b/ColourMeOKGame/Assets/Scripts/Colorimetry.cs
@@ -1,6 +1,9 @@
using System;
using UnityEngine;
+///
+/// class for anything related to colour spaces and models
+///
public static class Colorimetry
{
///
diff --git a/ColourMeOKGame/Assets/Scripts/DemoOklchColourPicker.cs b/ColourMeOKGame/Assets/Scripts/DemoOklchColourPicker.cs
index 186f336..f037611 100644
--- a/ColourMeOKGame/Assets/Scripts/DemoOklchColourPicker.cs
+++ b/ColourMeOKGame/Assets/Scripts/DemoOklchColourPicker.cs
@@ -1,5 +1,8 @@
using UnityEngine.UIElements;
+///
+/// class that inherits from OklchColourPickerUI for the demo colour picker on the DefaultView
+///
public class DemoOklchColourPicker : OklchColourPickerUI
{
///
diff --git a/ColourMeOKGame/Assets/Scripts/LocalPlayerData.cs b/ColourMeOKGame/Assets/Scripts/LocalPlayerData.cs
index b1f3a52..f77d47b 100644
--- a/ColourMeOKGame/Assets/Scripts/LocalPlayerData.cs
+++ b/ColourMeOKGame/Assets/Scripts/LocalPlayerData.cs
@@ -4,6 +4,9 @@
using System.Linq;
using UnityEngine;
+///
+/// local player data structure/class
+///
public class LocalPlayerData
{
///
diff --git a/ColourMeOKGame/Assets/Scripts/SideViewUI.cs b/ColourMeOKGame/Assets/Scripts/SideViewUI.cs
index e3cc9b4..7d88455 100644
--- a/ColourMeOKGame/Assets/Scripts/SideViewUI.cs
+++ b/ColourMeOKGame/Assets/Scripts/SideViewUI.cs
@@ -2,7 +2,7 @@
using UnityEngine.UIElements;
///
-/// singleton for a single source of truth game state and flow management
+/// class that handles the side view ui
///
public class SideViewUI : MonoBehaviour
{