<!--
Add one of the following kinds:
/kind bug
/kind cleanup
/kind documentation
/kind feature

Optionally add one or more of the following kinds if applicable:
/kind api-change
/kind deprecation
/kind failing-test
/kind flake
/kind regression
-->

#### What this PR does / why we need it:

#### Which issue(s) this PR is related to:
<!--
Please link relevant issues to help with tracking.

   * href="https://github.com/aappleby/smhasher/blob/master/src/MurmurHash3.cpp">32-bit murmur3
   * algorithm, x86 variant</a> (little-endian variant), using the given seed value, <b>with a known
   * bug</b> as described in the deprecation text.
   *
   * <p>The C++ equivalent is the MurmurHash3_x86_32 function (Murmur3A), which however does not
   * have the bug.
   *
   * @deprecated This implementation produces incorrect hash values from the {@link

            assertTrue(Modifier.isFinal(field.getModifiers()));
            assertEquals(int.class, field.getType());
        }
    }

    @Nested
    @DisplayName("Deprecation Tests")
    class DeprecationTests {

        @Test
        @DisplayName("Handler class should be deprecated")
        void testDeprecatedAnnotation() {
            // Then

            <type>String</type>
            <multiplicity>*</multiplicity>
          </association>
        </field>
        <field>
          <version>1.0.0</version>
          <name>deprecation</name>
          <description>A preferred alternative to this expression, in the case where it's deprecated.</description>
          <type>String</type>
        </field>
        <field>

    }

    @Test
    @DisplayName("Interface cannot be instantiated")
    @SuppressWarnings("deprecation") // Using Class#newInstance for explicit InstantiationException
    void cannotInstantiateInterface() {

## Documentation Deprecate a *Path Operation* - OpenAPI { #documentation-deprecate-a-path-operation-openapi }

To deprecate a *path operation*, and show it in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Deprecation](../tutorial/path-operation-configuration.md#deprecate-a-path-operation){.internal-link target=_blank}.

## Convert any Data to JSON-compatible { #convert-any-data-to-json-compatible }

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;

/**
 * Test for {@link ProjectBuildingException} message generation.
 */
@SuppressWarnings("deprecation")
class ProjectBuildingExceptionTest {

    @Test
    void testDetailedExceptionMessageWithMultipleProblems() {
        List<ProjectBuildingResult> results = new ArrayList<>();

     */
    @JvmStatic
    @Throws(IOException::class)
    fun get(protocol: String): Protocol {
      // Unroll the loop over values() to save an allocation.
      @Suppress("DEPRECATION")
      return when (protocol) {
        HTTP_1_0.protocol -> HTTP_1_0
        HTTP_1_1.protocol -> HTTP_1_1
        H2_PRIOR_KNOWLEDGE.protocol -> H2_PRIOR_KNOWLEDGE
        HTTP_2.protocol -> HTTP_2

        setComponentFactory(language);
    }

    /**
     * @return Description with reason of a Mojo deprecation.
     */
    public String getDeprecated() {
        return deprecated;
    }

    /**
     * @param deprecated Description with reason of a Mojo deprecation.
     */
    public void setDeprecated(String deprecated) {
        this.deprecated = deprecated;
    }

    /**

import org.apache.maven.model.Resource;
import org.apache.maven.project.artifact.AttachedArtifact;
import org.codehaus.plexus.logging.AbstractLogEnabled;

/**
 * DefaultMavenProjectHelper
 */
@SuppressWarnings("deprecation")
@Named
@Singleton
public class DefaultMavenProjectHelper extends AbstractLogEnabled implements MavenProjectHelper {
    private final ArtifactHandlerManager artifactHandlerManager;

    @Inject