doc: add a note on isl_dim_type