small adjustments
add notes for code samples