add doc sociable machines