reorganize to be more novice-friendly, add more docs
23 files changed