update comment to mention casing pitfalls