returning UUIDs instead of IDs, final documentation touches.