Document which classes are preferred and which are just to assist adapting legacy credential implementations