fixed documentations for samples 1-31