Add directory docs
Created by: kenrestivo
Warning: this is based on my (possibly incorrect/incomplete?) reading of https://macgirvin.com/display/4acdbf7403aa244044d403820274b1b1142f57bbc0b38d0ea0e35e49f36eceb7@macgirvin.com
It might need further editing before merging.