chore: minor docs after code review

Author: nytamin

packages/job-worker/src/jobs/index.ts

@@ -104,13 +104,14 @@ export interface StudioCacheContext {
 	 */
 	readonly studioId: StudioId
 	/**
-	 * The Studio the job belongs to
+	 * The Studio the job belongs to.
+	 * This has any ObjectWithOverrides in their computed/flattened form
 	 */
 	readonly studio: ReadonlyDeep<JobStudio>
 
 	/**
-	 * // nocommit: so whats the difference between studio and rawStudio?
 	 * The Studio the job belongs to
+	 * This has any ObjectWithOverrides in their original form
 	 */
 	readonly rawStudio: ReadonlyDeep<DBStudio>
 

packages/job-worker/src/workers/caches.ts

@@ -100,8 +100,15 @@ export class WorkerDataCacheWrapperImpl implements WorkerDataCacheWrapper {
  * This is a reusable cache of these properties
  */
 export interface WorkerDataCache {
+	/**
+	 * The Studio the cache belongs to
+	 * This has any ObjectWithOverrides in their original form
+	 */
 	rawStudio: ReadonlyDeep<DBStudio>
-	// nocommit: maybe add description of what this is, why is it different from rawStudio
+	/**
+	 * The Studio the cache belongs to.
+	 * This has any ObjectWithOverrides in their computed/flattened form
+	 */
 	jobStudio: ReadonlyDeep<JobStudio>
 	studioBlueprint: ReadonlyDeep<WrappedStudioBlueprint>
 	studioBlueprintConfig: ProcessedStudioConfig | undefined