More documentation appreciated on the `Sample` class

The Sample class, which is in the core of your database design, is a bit undocumented. Could you please improve that a bit?