Skip to content
Dr. Gernot Starke edited this page Sep 28, 2020 · 1 revision

Welcome to the examination-foundation wiki!

Rough idea for consistent versioning

  • move to AsciiDoc as technical format for questions AND answers

  • ID and text of a questions is always included

  • put answers next to questions in adoc, but use different tags ("OPTIONS", "ANSWER")

  • similar to language versions in curriculum, let the build process generate two different output documents

Separating questions and answers in a single AsciiDoc file

Question 42 (ID 20-05-01)

What are the two best reasons to favour AsciiDoc over binary formats like docx?

// tag::OPTIONS[]

(a) It starts with the letter "A"
(b) Its plain text an can be merged
(c) Its open source
(d) The tools have been written in the Ruby language

// end::OPTIONS[]

// tag::ANSWER[]
b,c
// end::ANSWER[]

This solution has the disadvantage that it’s styled differently compared to the original questions, as there are a,b,c as identifiers for the different answering-options…​ but who cares?

Rendering of various questions types in AsciiDoc

We can use AsciiDoc tables to align answers.

Some volunteer need to create a prototype