[docs] update example and docs with details about