• View
• Edit
• History
• Print

UniqueIdentifier

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

Add a unique identifier to each lesson file

We add a unique identifier to each lesson file. It will be defined by the lesson_id variable in the header block, like this:

 lesson_id = "af42fbd5-e86d-4daa-b76d-5c6985da9e29"

You can use any string you want as lesson_id, but you should choose something that has a chance to be unique. We need a policy for this.

The identifier will be used when building learning trees, and when storing statistics and test results for exercises. So we won't refer to the actual file names. This means that files can be edited and renamed without any hazzle. We will have to do a md5sum check like we do today for the saved statistics and test results.

Solfege will check that alls lesson_ids are unique at startup, and will offer to generate a new identifier if more than one file has the same identifier.

uuidgen code

We will use this code to generate the identifiers for lesson files that don't have it. The code should be cross platform, but I still has to test.

Creating learning trees

I will add a GUI to solfege that can edit and create learning trees.

Why this idea is great

• Fits nicely with the goals written on this page.
• Fits nicely with existing code. We already parse all files on startup, so we just have to extend the LessonFileManager.
• When we can define learning trees in a single file, and several learning trees can refer to the same lesson file. We can also easily rename lesson files without having to update the learning trees.

Why this idea sucks

Creating learning trees manually with a text editor can be a little more difficult because you have to write the lesson-id correctly.