more scratch work and cleanup of README, plus a section on runtime environment modifications