reworked representations, updated docs and tests accordingly