add docs and tidy-up sam/Makefile; "make upload" still broken