updated more text and examples