fix lint
fix naming of relations, add more specs
docs for relations