refactoring rest-list write methods, docs for composite id logic