/**
     * Adds the description of some candidate.
     */
    DiagnosticsVisitor candidate(String displayName);

    /**
     * Adds an example for the previous candidate. Can have multiple examples.
     */
    DiagnosticsVisitor example(String example);

    /**
     * Adds a set of potential values for the previous candidate, if known.
     */
    DiagnosticsVisitor values(Iterable<?> values);

            import lombok.val;

            public class ValExample {
              public String example() {
                val example = new ArrayList<String>();
                example.add("Hello, World!");
                val foo = example.get(0);
                return foo.toLowerCase();
              }

              public void example2() {
                val map = new HashMap<Integer, String>();
                map.put(0, "zero");

They can be set from the command line using the `-P` / `--project-prop` <<command_line_interface.adoc#sec:environment_options, environment option>>.

The following examples demonstrate how to set project properties in different ways.

*Example 1:* Setting a project property via the *command line*:
====
----
$ gradle -PgradlePropertiesProp=commandLineValue
----
====

 * a number of capabilities. Some examples:
 *
 * <ul>
 * <li>An implementation may decorate the instances in some fashion, for example to mix in the Groovy DSL, and so may return a subclass of the requested type.
 *
 * <li>An implementation may accept abstract classes or interfaces and provide implementations for the missing pieces, for example providing an implementation of ExtensionAware.
 *

Laura Kassovic <******@****.***> 1701107622 -0800

* Convert the copied model to something that can be stored in your DB (for example, using the `jsonable_encoder`).
    * This is comparable to using the model's `.model_dump()` method again, but it makes sure (and converts) the values to data types that can be converted to JSON, for example, `datetime` to `str`.
* Save the data to your DB.
* Return the updated model.

=== "Python 3.10+"

     * discard.
     *
     * E.g. `x` in the following examples *are* used (`x.isUsedAsExpression() == true`)
     *   - `if (x) { ... } else { ... }`
     *   - `val a = x`
     *   - `x + 8`
     *   - `when (x) { 1 -> ...; else -> ... }
     *
     * E.g. `x` in the following example is definitely *not* used (`x.isUsedAsExpression() == false`)
     *   - `run { x; println(50) }`

See the License for the specific language governing permissions and
limitations under the License.
*/

// +k8s:deepcopy-gen=package
// +groupName=cr.example.apiextensions.k8s.io

// Package v1 is the v1 version of the API.

Laura Kassovic <******@****.***> 1701107622 -0800

}

.section .titlepage {
    page-break-after: avoid;
}

p {
    text-align: justify;
}

/**
 * Examples
 */

.example .title {
    text-align: left;
    white-space: nowrap;
    color: #666666
}

.example {
    page-break-inside: avoid;
}

.figure .title {
    text-align: left;
    white-space: nowrap;
    color: #666666
}