starting array-realiz in earnest
documentation additions