improved sanity checks + examples