improved examples doc