3827 permalinks

675adc3 satisfies Steve's request. Commits that follow doc's modify directory structure as spec'ed on that JIRA