documentation for two sample stuff