model/threads: add documentation comments