[library] Add more information about the semantics of part indexes