added examples links and fixed descriptions
updated documentation