Document the set interface

maybe mention not thread safe.