From 3a1d6ad966b4534b2428c86b3c79caafe1973ebf Mon Sep 17 00:00:00 2001 From: Rebecca Phuonghanh Dang Date: Wed, 16 Apr 2025 09:33:21 -0700 Subject: [PATCH 1/2] Add Exams section and Writing Exams page --- exams/index.md | 8 ++++++++ exams/writing-exams.md | 27 +++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) create mode 100644 exams/index.md create mode 100644 exams/writing-exams.md diff --git a/exams/index.md b/exams/index.md new file mode 100644 index 0000000..3a7cdb8 --- /dev/null +++ b/exams/index.md @@ -0,0 +1,8 @@ +--- +layout: page +title: Exams +nav_order: 3 +has_children: true +--- + +# Exams diff --git a/exams/writing-exams.md b/exams/writing-exams.md new file mode 100644 index 0000000..e7e296d --- /dev/null +++ b/exams/writing-exams.md @@ -0,0 +1,27 @@ +--- +layout: page +title: Writing Exams +parent: Exams +nav_order: 1 +--- + +# Writing Exams + +## Tools + +Many tools have been used over the years for writing exams, including: + +- Latex, typically using [Overleaf](https://www.overleaf.com/) for its in-browser editor, compiler, and previewer and its collaboration features +- CS 61A's [examtool](https://pypi.org/project/examtool/) which is a combination of tools: + - The now deprecated examtool web app which allowed students to take exams online + - The examtool CLI which allows instructors/TAs to compile exams from .md and .tex files to PDF + - The examtool Markdown syntax +- Most recently, [Typst](https://typst.app/), a Latex and Overleaf alternative, has been gaining popularity for its in-browser editor, compiler, and previewer and its local features + - CS 61C has a Typst exam template [61c-examst](https://github.com/61c-teach/cs61c-examst) developed by Andrew Liu (liu.andrew@) + +## Pedagogical Guidelines + +{: .highlight } +This section is under construction. + +- [CS 161 Pedagogy Blog: Exam Writing I](https://pedagogy.cs161.org/2022/02/06/exam-writing-i/) From f1017f1bf39966893f73629aa1e260c76b1a4249 Mon Sep 17 00:00:00 2001 From: Silas Santini <70163606+pancakereport@users.noreply.github.com> Date: Thu, 8 May 2025 11:20:41 -0700 Subject: [PATCH 2/2] slight reorganization + prairielearn --- exams/index.md | 4 ++++ exams/writing-exams.md | 13 +++---------- 2 files changed, 7 insertions(+), 10 deletions(-) diff --git a/exams/index.md b/exams/index.md index 3a7cdb8..7614c84 100644 --- a/exams/index.md +++ b/exams/index.md @@ -6,3 +6,7 @@ has_children: true --- # Exams + +## Quick Links + +- [CS 161 Pedagogy Blog: How to Write Solid Exam Questions](https://pedagogy.cs161.org/2022/02/06/exam-writing-i/) \ No newline at end of file diff --git a/exams/writing-exams.md b/exams/writing-exams.md index e7e296d..3f1064c 100644 --- a/exams/writing-exams.md +++ b/exams/writing-exams.md @@ -1,13 +1,11 @@ --- layout: page -title: Writing Exams +title: Tools for Writing Exams parent: Exams nav_order: 1 --- -# Writing Exams - -## Tools +# Tools for Writing Exams Many tools have been used over the years for writing exams, including: @@ -16,12 +14,7 @@ Many tools have been used over the years for writing exams, including: - The now deprecated examtool web app which allowed students to take exams online - The examtool CLI which allows instructors/TAs to compile exams from .md and .tex files to PDF - The examtool Markdown syntax +- [PrairieLearn](https://www.prairielearn.com/) - Most recently, [Typst](https://typst.app/), a Latex and Overleaf alternative, has been gaining popularity for its in-browser editor, compiler, and previewer and its local features - CS 61C has a Typst exam template [61c-examst](https://github.com/61c-teach/cs61c-examst) developed by Andrew Liu (liu.andrew@) -## Pedagogical Guidelines - -{: .highlight } -This section is under construction. - -- [CS 161 Pedagogy Blog: Exam Writing I](https://pedagogy.cs161.org/2022/02/06/exam-writing-i/)