thread code documentation (and release notes)