Revisions to L03 - requirements

Lectures/Deadlines.tex

@@ -5,7 +5,7 @@
 
 ~\newline
 \begin{tabular}{l l l}
-SRS & Week 03/04 & Week of Jan 16, 23\\
+SRS & Week 03/04 & Week of Jan 23, 30\\
 Syst.\ VnV & Week 06 & Week of Feb 13\\
 POC Demo & Week 06, 07 & Week of Feb 13, 27\\
 MG + MIS Syntax & Week 09 & Week of Mar 13\\
@@ -30,7 +30,7 @@ Drasil & Week 11/12 & Week of Mar 27, Apr 3\\
 \frametitle{Administrative Details: Draft Report Deadlines}
 ~\newline
 \begin{tabular}{l l l}
-Problem Statement & Week 02 & Jan 20\\
+\textbf{Problem Statement} & Week 02 & Jan 20\\
 System Requirements Specification (SRS) & Week 04 & Feb 3\\
 System VnV Plan & Week 06 & Feb 17\\
 Module Guide (MG) + Mod Int Spec (MIS) & Week 09 & Mar 17\\

Lectures/L03_Requirements/Requirements.tex

@@ -321,7 +321,7 @@ unambiguous and verifiable?
 \structure{What are some examples of excellent usability?}\\
 ~\\
 \structure{When you visit a hotel, especially in another country, do you expect
-  some confusion with operating the shower?}
+  some confusion with operating the shower? the microwave? the TV?}
 
 \end{frame}
 
@@ -339,6 +339,8 @@ unambiguous and verifiable?
 \item Human computer interaction (HCI) is a major interdisciplinary subject
   concerned with understanding and improving interaction between humans and
   computers
+\item \textbf{If you project is relatively simple, usability is a place where
+your project can ``shine''}
 \end{itemize}
 % talk about IBM usability lab and other things that Muir mentioned
 \end{frame}
@@ -374,6 +376,8 @@ unambiguous and verifiable?
   environments, and methods
 \item Software reuse decreases productivity in the short term, but increases
   productivity in the long term
+\item See \href{https://arxiv.org/pdf/2112.12580.pdf} {SmithAndCarette2021} for
+some thoughts on productivity
 \end{itemize}
 
 \end{frame}
@@ -508,7 +512,7 @@ What do software developers do to promote maintainability?
 \frametitle{Reproducibility}
 
 \begin{itemize}
-\item Interest is growing \cite{BenureauAndRougier2017, BaileyEtAl2016}
+\item Interest is growing \cite{BaileyEtAl2016, BenureauAndRougier2017}
 \item Progress on re-running old code with docker, VMs
 \item Replicability is rarely achieved, as shown for microarray gene expression
   \cite{IoannidisEtAl2009} and for economics modelling
@@ -594,33 +598,41 @@ Draw a diagram showing the relationships between the various software qualities
 \begin{frame}
 \frametitle{Goal Statements for SWHS}
 
-\structure{What are the goal statement for the Solar Water Heating System?}
-\structure{Think in terms of what are the inputs and outputs? For the goals, you
-might want to first think about the outputs.}
+\structure{What are the goal statement for the Solar Water Heating System?
+(\href{https://jacquescarette.github.io/Drasil/examples/nopcm/SRS/srs/NoPCM_SRS.html}
+(NoPCM SRS))} 
+
+~\\
+
+\structure{Think in terms of what are the inputs and outputs? For
+the goals, you might want to first think about the outputs.}
+
 \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \begin{frame}
-\frametitle{Goal Statements for SWHS}
+\frametitle{Goal Statements for noPCM}
 
 \noindent Given the temperature of the heating coil, initial conditions for the
-temperature of the water and the temperature of the phase change material, and
-material properties, the goal statements are:
+temperature of the water, and material properties, the goal statements are:
 
 \begin{itemize}
 
 \item[GS1:] Predict the water temperature over time.
 
-\item[GS2:] Predict the PCM temperature over time.
-	
 \item[GS3:] Predict the change in the energy of the water over time.
 
-\item[GS4:] Predict the change in the energy of the PCM over time.
-
 \end{itemize}
 
-(Consider using names instead of numbers for labels.)
+~\\
+
+\begin{itemize}
+  \item Consider using names instead of numbers for labels.
+  \item For
+\href{https://jacquescarette.github.io/Drasil/examples/swhs/SRS/srs/SWHS_SRS.html}
+{SWHS} add goals related to the Phase Change Material
+\end{itemize}
 
 \end{frame}
 
@@ -629,21 +641,31 @@ material properties, the goal statements are:
 \begin{frame}
 \frametitle{Goal Statements for GlassBR}
 
+For
+\href{https://jacquescarette.github.io/Drasil/examples/glassbr/SRS/srs/GlassBR_SRS.html}
+{GlassBR}:
+
+~\\
+
 Given the dimensions of the glass plane, glass type, the characteristics of the explosion, and
 the tolerable probability of breakage, the goal statements are:
 \begin{itemize}
-\item[GS1:] Analyze and predict whether the
-  glass slab under consideration will be able to withstand the explosion of a
-  certain degree which is calculated based on user input.
+\item[GS1:] Analyze and predict whether the glass slab under consideration will
+  be able to withstand the explosion of a certain degree which is calculated
+  based on user input.
 \end{itemize}  
 
 \end{frame}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\begin{frame}
+\begin{frame}[plain]
 \frametitle{Goal Statements for Game Physics}
 
+\noindent For
+\href{https://jacquescarette.github.io/Drasil/examples/gamephysics/SRS/srs/GamePhysics_SRS.html}
+{Game Physics}:
+
 \begin{itemize}
 	
 \item[G\_linear:] Given the physical properties, initial positions and
@@ -722,19 +744,19 @@ Also Goal Statements and Requirements
 \begin{itemize}
 
 \item
-  \href{https://jacquescarette.github.io/Drasil/examples/Projectile/srs/Projectile_SRS.html}
+  \href{https://jacquescarette.github.io/Drasil/examples/projectile/SRS/srs/Projectile_SRS.html}
   {Projectile Example}
 \item
-  \href{https://jacquescarette.github.io/Drasil/examples/GlassBR/srs/GlassBR_SRS.html}
+  \href{https://jacquescarette.github.io/Drasil/examples/glassbr/SRS/srs/GlassBR_SRS.html}
   {GlassBR Example}
 \item
-  \href{https://jacquescarette.github.io/Drasil/examples/SWHS/srs/SWHS_SRS.html}
+  \href{https://jacquescarette.github.io/Drasil/examples/swhs/SRS/srs/SWHS_SRS.html}
   {SWHS Example}
 \item
-  \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/blob/master/BlankProjectTemplate/docs/SRS/SRS.pdf}
-  {Blank SRS}
+  \href{https://github.com/smiths/capTemplate/blob/main/docs/SRS/SRS.pdf}
+  {Blank SRS from Template}
 \item
-  \href{https://gitlab.cas.mcmaster.ca/smiths/cas741/blob/master/BlankProjectTemplate/docs/SRS/SRS-Checklist.pdf} {Checklist}
+  \href{https://github.com/smiths/capTemplate/blob/main/docs/Checklists/SRS-Checklist.pdf} {Checklist}
 \end{itemize}
 
 \end{frame}