contributors to follow so that we can have a chance of keeping on top of
things.

Some of the ideas are documented in the [Maven Wiki][maven-wiki]
which might be interesting to read and for further discussion.

Getting Started
---------------

+ Make sure you have a [JIRA account](https://issues.apache.org/jira/).
+ Make sure you have a [GitHub account](https://github.com/signup/free).

        // phase 1
        DefaultModelBuilderResult result = new DefaultModelBuilderResult();

        DefaultModelProblemCollector problems = new DefaultModelProblemCollector(result);

        // read and validate raw model
        Model fileModel = readFileModel(request, problems);
        result.setFileModel(fileModel);

        Model activatedFileModel = activateFileModel(fileModel, request, result, problems);

DEFAULT_END_TOKEN; public void InterpolationFilterR(java.io.Reader, java.util.Map, String, String); public void InterpolationFilterR(java.io.Reader, java.util.Map); public long skip(long) throws java.io.IOException; public int read(char[], int, int) throws java.io.IOException; public int read() throws java.io.IOException; static void <clinit>(); } org/codehaus/plexus/util/introspection/ClassMap$1.class package org.codehaus.plexus.util.introspection; synchronized class ClassMap$1 { } org/codehaus/plexus/ut...

DEFAULT_END_TOKEN; public void InterpolationFilterR(java.io.Reader, java.util.Map, String, String); public void InterpolationFilterR(java.io.Reader, java.util.Map); public long skip(long) throws java.io.IOException; public int read(char[], int, int) throws java.io.IOException; public int read() throws java.io.IOException; static void <clinit>(); } org/codehaus/plexus/util/introspection/ClassMap$1.class package org.codehaus.plexus.util.introspection; synchronized class ClassMap$1 { } org/codehaus/plexus/ut...

        MavenStaxReader modelReader = new MavenStaxReader();
        try {
            model = new Model(modelReader.read(sReader));
        } catch (XMLStreamException e) {
            throw new ModelInterpolationException(
                    "Cannot read project model from interpolating filter of serialized version.", e);
        }

        return model;
    }

    /**

            String modelId = "org.apache.maven:maven-model-builder:" + version + "-"
                    + this.getClass().getPackage().getImplementationVersion() + ":super-pom";
            return modelProcessor.read(XmlReaderRequest.builder()
                    .modelId(modelId)
                    .location(url.toExternalForm())
                    .inputStream(is)
                    .strict(false)
                    .build());

 * <p>
 * A note to the reader;
 * </p>
 * <p>
 * There are several issues/discussions regarding how "aggregator" plugins should be handled.
 * Read for instance http://docs.codehaus.org/display/MAVEN/Deterministic+Lifecycle+Planning
 * </p>
 * <p>
 * In their current implementation they are "bolted" onto the lifecycle by separating them

    @Nullable
    String getModelId();

    @Nullable
    String getLocation();

    boolean isAddDefaultEntities();

    interface Transformer {
        /**
         * Interpolate the value read from the xml document
         *
         * @param source    The source value
         * @param fieldName A description of the field being interpolated. The implementation may use this to
         *                  log stuff.

            return properties;
        }

        try (Reader reader = Files.newBufferedReader(path)) {
            properties.load(reader);
        } catch (IOException e) {
            LOGGER.warn("Unable to read {}. The --resume / -r feature will not work.", path);
        }

        return properties;
    }

    // This method is made package-private for testing purposes

     * track the problem back to its origin. A concrete example for such a source hint can be the file path or URL from
     * which the settings were read.
     *
     * @return The hint about the source of the problem or an empty string if unknown, never {@code null}.
     */
    String getSource();

    /**