improves development setup documentation
fixes sample_data script
improves sample data error messages