adding require and extending documentation