Explanatory comments

gui/src/app/Scripting/Analysis/useAnalysisState.ts

@@ -11,6 +11,9 @@ export type GlobalDataForAnalysis = {
   numChains: number;
 };
 
+// A custom hook to share logic between the Python and R analysis windows
+// This contains the output div refs, the interpreter state, and the data from
+// the latest run.
 const useAnalysisState = (latestRun: StanRun) => {
   const consoleRef = useRef<HTMLDivElement | null>(null);
   const imagesRef = useRef<HTMLDivElement | null>(null);

gui/src/app/Scripting/DataGeneration/useDataGenState.ts

@@ -4,6 +4,8 @@ import { writeConsoleOutToDiv } from "@SpScripting/ScriptEditor";
 import { InterpreterStatus } from "@SpScripting/InterpreterTypes";
 import { ProjectContext } from "@SpCore/ProjectContextProvider";
 
+// A custom hook to share logic between the Python and R data generation windows
+// This contains the output div ref, the interpreter state, and the callback to update the data.
 const useDataGenState = () => {
   const [status, setStatus] = useState<InterpreterStatus>("idle");
   const consoleRef = useRef<HTMLDivElement>(null);

gui/src/app/Scripting/useTemplatedFillerText.ts

@@ -2,6 +2,8 @@ import { ProjectContext } from "@SpCore/ProjectContextProvider";
 import { ProjectKnownFiles } from "@SpCore/ProjectDataModel";
 import { useContext, useMemo } from "react";
 
+// This is used to create the text span used in the ScriptEditor component when the file is empty.
+// It features a brief description and a clickable link to generate an example template.
 const useTemplatedFillerText = (
   text: string,
   template: string,