Skip to content

Latest commit

 

History

History
66 lines (48 loc) · 3.68 KB

QUESTION_COLOR_GUIDE.md

File metadata and controls

66 lines (48 loc) · 3.68 KB

Question color guide

Use color to help students recognize important concepts and follow references to them across a question. Distinct concepts receive distinct, consistent colors. Reduce visual clutter by selecting fewer words to color while preserving useful differences between concepts.

The aim is a question where the key terms are easy to find and the surrounding text is easy to read. A coordinated palette supports this purpose; assigning every term the same accent loses the concept associations that make color useful.

Highlight the concepts

Give color to the terms students need to distinguish. Keep incidental vocabulary quieter: "sample," "organism," and "reaction" may deserve color when those are the concepts being tested, but often serve as background vocabulary in another question.

Use color selectively in both labels and prose. A matching label can carry color across its full name. In a longer statement, highlighting a compact reference may be enough. For example, coloring H0 in "null hypothesis, H0" can retain the association while leaving more of the sentence visually quiet. Preserve meaningful bold, italics, and scientific notation.

Keep repeated references, aliases, and singular/plural forms consistent within a question, its shuffled variants, and related banks that use the same concepts.

Support the matching task

Colored labels can help students recognize the terms they are comparing. Descriptions can also use color when they explicitly reference a concept. Let that reference carry its own concept's color, independently of the term being defined.

For example, a definition of the alternative hypothesis might say that it "conflicts with the null hypothesis." Coloring "null hypothesis" with its established color reinforces a useful reference. Coloring the entire definition with the alternative hypothesis's color would let students pair the answer by appearance alone.

Apply concept colors equally to correct and incorrect choices, including true and false statements. Color identifies the concept; the words determine whether the statement is correct.

Choose a coordinated palette

Choose colors from COLOR_PALETTE.md. Reuse assignments from REPO_COLOR_PALETTE.md for the materials it covers. For new sets, choose colors that remain easy to distinguish. Possible starting subsets include:

  • Four terms, cooler palette: teal, blue, purple, magenta.
  • Four terms, warm to cool: dark orange, dark yellow, green, sky blue.
  • Five terms, broader palette: light orange, green, sky blue, purple, magenta.

These are examples to compare in the rendered question, rather than fixed recipes. For four terms, approximately 45-degree hue spacing across a 135-degree arc is a useful starting point. It leaves more room for differentiation than packing four colors into a narrow arc. The existing template colors are fixed choices, so use their appearance rather than exact angle calculations. Vary the starting region between banks and keep assignments stable within a bank.

For larger term pools, choose from across the fixed palette. Assign colors to the full pool: if a question draws five terms from nine, each selected term retains its assigned color.

Read it as a student

Look at a rendered question: are the important concepts easy to find, are their colors visibly different, and is the surrounding text comfortable to read? Check that color reinforces the content without supplying unintended answer clues. Keep meaning complete through words and symbols when colors are hard to distinguish.

For contrast targets, measurements, and accessibility procedures, use COLOR_CONTRAST_ACCESSIBILITY.md.