Refresh Your Knowledge
======================

:Author: Ken & Kara Kundert
:Version: 0.0
:Released: 2025-09-06

Refresh is designed to help you keep your knowledge of a subject fresh by
asking you questions about that subject.

The questions are taken from a database that you create.  Use the ‘add’
command to add questions on a topic.  You will be presented with a NestedText
document that allows you to add multiple questions and answers to those
questions for a topic.  The questions and answered are formatted using
`MarkDown <www.markdownguide.org/basic-syntax>`_ that can include Latex
equations when delimited using $$.

Topics are grouped into ‘subjects’.  Multiple subjects can be specified when
creating the topic with the subjects being arbitrary words or phrases.  Then,
when starting a quiz you can limit the topics to one or more subjects.

Topics are named and can be organized into ‘directories’.  For example, a name
of ‘radiation’ would be held at the top-level whereas ‘physics/radiation’
would be held in the ‘physics’ directory.  Any number of levels are supported.


Getting Help
------------

The *help* command provides information on how to use Refresh's various
features.  To get a listing of the topics available, use::

    refresh help

Then, for information on a specific topic use::

    refresh help <topic>