• View
• Edit
• History
• Print

LearningTreeEditor

This page does not desribe the current implementation. It was a draft used for discussion. Parts of it has been implemented.

Let us prepare the user documentation for the graphics learning tree editor here, and move it to SolfegeDocs? when we have a released version. I'm exceptionally bad at writing user documentation, so please contribute here when you get the chance to test the editor.

'''Hm, I see we sometimes talk about lessons and sometimes about exercises. We should use just one name. Mabye 'lessons' are not that stupid, if we add theory texts to each exercise? '''

Goals

• The editor should be easy to use.
• The editor should prevent the user from doing stupid things, like circular dependencies
• The editor should integrate nicely with the lesson file editor.

The docs

In GNU Solfege, all exercises are available from the "Exercise" menu. The exercises are grouped in topics, and each topic has a submenu on the "Exercise menu".

The program maintains a list of all registered lesson files and all their dependencies. A topic is just a 'view' of a subset of the exercises. So if a lesson is registred in two or more topics, changing the dependencies in one topic will change the dependencies in all topics.

When you click on a topic, a list of the lessons in the learning tree is displayed below the topic list. The list is ordered with the easies lessons on the top, and more difficult lessons further down the list. The ordering is calculated based on the dependencies between the lessons.

Dependencies

It is possible to declare dependences between lessons. "lesson B" depends on "lesson A" means the user is supposed to practise "lesson A" before (s)he practises "lesson B".

Visibility

The entry "Default visibility" tell Solfege how many lessons that should be available on the Practise and Test menu. The value '0' means that only lessons without tests and lessons with tests that you have passed should be visible. The value '1' show all lessons form value '0', and also all lessons that depends on lessons with tests you have passed. Value '2' show even more tests etc.