update apiary documentation, rest and domain models