Improved document strings in vid_database.rs

[squell]

Some of these functions represent ideas that are in our heads, but should be written down (to get them into the heads of others, which includes our future selves)