add examples section and function documentation