add some docs, rename to singular