even more docs...
preparing to implement timeout feature