Association documentation

Working on #1097 

- move docs into subfolders
- improve docs readme
- improve docs index.html