preliminary documentation (week 1)