partway through minor overhaul
fix anchors and h1
fix permissions
doc intro
lots more added to docs & style