\paragraph{Maximize Creative Freedom}
OS design involves a tremendous amount of creative freedom, both in the
-choice of algorithm and data structures. Our projects are designed to
+choice of algorithms and data structures. Our projects are designed to
stimulate creativity by avoiding the prescription of specific approaches
-to accomplish each project's goals. Instead, students must design their
+to accomplish each project's goals. Instead, students design their
own data structures and associated algorithms as much as possible.
\paragraph{Practice Test-driven Development}
\paragraph{Include Analysis Tools}
Static and dynamic analysis tools are now being widely used; an OS course should
-be no exception. We have extended the QEMU emulator~\cite{Bellard2005QEMU} to
-perform tailored analyses that point out errors such as race conditions.
+be no exception. In Section~\ref{sec:dynamicanalysis}, we describe how we
+extended the QEMU emulator~\cite{Bellard2005QEMU} to
+perform tailored analyses that find errors such as race conditions.
\paragraph{Provide Extensive and Structured Documentation}
If using an instructional system requires too much undocumented knowledge,
-the system is often not shared, or falls into disuse, because the learning curve
-for instructors wishing to use it is too steep and training teaching assistants is difficult.
+the system is often not shared or falls into disuse because the learning curve
+for instructors is too steep and training teaching assistants is difficult.
Pintos includes an extensive 129 page manual, a sample solution,
-and instructions for teaching assistants. The assignment documentation separates sections
-students must read from sections that merely provide supplemental information.
+and grading instructions for teaching assistants. The project documentation
+highlights sections students must read from sections that merely provide supplemental information.
%Even though Pintos uses an existing and complex architecture, our experience indicates
%that the manual is sufficient for most students.