wip: add associations and work through examples in documentation