add more comments around the delinearization of arrays