add docs for cases to introduction