added long descriptions in external paragraph
updated README