modified arrays interface and docs