doc with examples