feat: improved import messaging

- Added missing docstring

internal/provider/resource_access_generic.go

@@ -476,8 +476,7 @@ func newJaasAccessID(targetTag names.Tag, accessStr string) string {
 func retrieveJaasAccessFromID(ID types.String, diag *diag.Diagnostics) (resourceTag names.Tag, access string) {
 	resID := strings.Split(ID.ValueString(), ":")
 	if len(resID) != 2 {
-		diag.AddError("Malformed ID", fmt.Sprintf("Access ID %q is malformed, "+
-			"please use the format '<resourceTag>:<access>:'", resID))
+		diag.AddError("Malformed ID", fmt.Sprintf("Access ID %q is malformed", resID))
 		return nil, ""
 	}
 	tag, err := jimmnames.ParseTag(resID[0])
@@ -488,14 +487,16 @@ func retrieveJaasAccessFromID(ID types.String, diag *diag.Diagnostics) (resource
 	return tag, resID[1]
 }
 
+// Importstate validates the user provided ID and attempts to create a resource by
+// reading and importing the object referred to by the provided ID.
 func (a *genericJAASAccessResource) ImportState(ctx context.Context, req resource.ImportStateRequest, resp *resource.ImportStateResponse) {
 	IDstr := req.ID
 	resID := strings.Split(IDstr, ":")
 	if len(resID) != 2 {
 		resp.Diagnostics.AddError(
 			"ImportState Failure",
 			fmt.Sprintf("Malformed Import ID %q, "+
-				"please use format '<resourceTag>:<access>' e.g. %s", IDstr, a.targetResource.ImportHint()),
+				"please use format %q", IDstr, a.targetResource.ImportHint()),
 		)
 		return
 	}

internal/provider/resource_access_jaas_model.go

@@ -62,7 +62,7 @@ func (j modelInfo) Save(ctx context.Context, setter Setter, info genericJAASAcce
 
 // ImportHint implements [resourceInfo] and provides a hint to users on the import string format.
 func (j modelInfo) ImportHint() string {
-	return "model-<UUID>:writer"
+	return "model-<UUID>:<access-level>"
 }
 
 type jaasAccessModelResource struct {