given:
        sampleDoc << """
=== Invalid Javadoc Links

     * will fail.
     *
     * @param attributes the attributes in order
     *
     * @since 7.5
     * @see #setAttributeDisambiguationPrecedence(List)
     */
    @Incubating
    void attributeDisambiguationPrecedence(Attribute<?>... attributes);

    /**

        EmptySchema.INSTANCE.attributeDisambiguationPrecedence(Attribute.of("attribute", String))
        then:
        thrown(UnsupportedOperationException)

        when:
        EmptySchema.INSTANCE.setAttributeDisambiguationPrecedence([Attribute.of("attribute", String)])
        then:
        thrown(UnsupportedOperationException)
    }

    }

    @Override
    public void attributeDisambiguationPrecedence(Attribute<?>... attribute) {
        throw new UnsupportedOperationException();
    }

    @Override
    public void setAttributeDisambiguationPrecedence(List<Attribute<?>> attributes) {
        throw new UnsupportedOperationException();
    }

    @Override
    public List<Attribute<?>> getAttributeDisambiguationPrecedence() {

                throw new IllegalArgumentException(String.format("Attribute '%s' precedence has already been set.", attribute.getName()));
            }
        }
    }

    @Override
    public void setAttributeDisambiguationPrecedence(List<Attribute<?>> attributes) {
        precedence.clear();
        attributeDisambiguationPrecedence(attributes.toArray(new Attribute<?>[0]));
    }

    @Override

                    disambiguationRules.add(CategorySelectionRule)
                }

                def usage = getAttributes().find { it.name == 'org.gradle.usage' }
                setAttributeDisambiguationPrecedence([flavor, usage])
            }
        """.stripIndent()

        when:
        succeeds ':resolvableConfigurations'

        then:

[[changes_7.6]]
== Upgrading from 7.5 and earlier

=== Updates to Attribute Disambiguation Rules related methods