add notes around suite definition