improve doc with examples