code: public static EditableArray newArray( Collection<?> values ) {
          BasicArray array = new BasicArray(values.size());
          array.addAllValues(values);
          return new ArrayEditor(array, DEFAULT_FACTORY);
      }
docs: Create a new editable array that can be used as a new array value in other documents.
  
  @param values the initial values for the array
  @return the editable array; never null