Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[jakartaee-spec-project-leads] References to spec sections

Hi,

I was wondering what I should do about text like this in the Mojarra / Server Faces project:

/**
         * <p class="changed_added_2_3">This value indicates CDI should be used
         * for Jakarta _expression_ Language resolution as well as enabling Jakarta Server Faces CDI injection, as specified
         * in Section 5.6.3 "CDI for EL Resolution" and Section 5.9 "CDI Integration".</p>
         */
        JSF_2_3

The section itself refers to a section which is currently not there in the Jakarta Server Faces spec (and may well never be there), but the reference also contains the abbreviation that is to be replaced. After replacing it, it won't refer to any existing section title.

I'm inclined to just remove the reference, so it becomes:

/**
         * <p class="changed_added_2_3">This value indicates CDI should be used
         * for Jakarta _expression_ Language resolution as well as enabling Jakarta Server Faces CDI injection.</p>
         */
        JSF_2_3

Thoughts?

Kind regards,
Arjan


Back to the top