Reviewing files that changed from the base of the PR and between b20b80a and 677d23f.

• NEWS.md (1 hunks)
• doc/metrics/metrics-family.rst (1 hunks)
• doc/metrics/pgr_degree.rst (4 hunks)
• doc/src/experimental.rst (0 hunks)
• doc/src/proposed.rst (0 hunks)
• doc/src/release_notes.rst (1 hunks)
• doc/src/routingFunctions.rst (2 hunks)
• sql/metrics/degree.sql (0 hunks)

• doc/src/experimental.rst
• doc/src/proposed.rst
• sql/metrics/degree.sql

• GitHub Check: Codacy Static Code Analysis
• GitHub Check: Check queries

doc/metrics/pgr_degree.rst (2)

11-12: Index Update for Official Promotion
The new index entries (“single: Metrics Family ; pgr_degree” and “single: degree”) now clearly group the function under its metrics family. This change is consistent with promoting the function to official status.

---

31-33: Official Status and Signature Update Noted
The bullet points in the “Version 3.8.0” section now list:
– Error messages adjustment
– New signature with only Edges SQL
– Function promoted to official
This clearly documents the evolution. The later “Version 3.4.0” section still notes “New proposed function” to retain historical context. This is appropriate per the pgRouting documentation guidelines.

doc/src/release_notes.rst (1)

50-60:

❓ Verification inconclusive

Clarity on Renaming: pgr_degree vs. pgr_findCloseEdges
The release notes now include two bullet items—one for pgr_degree and one for pgr_findCloseEdges. Since the PR objectives state that the function previously known as “pgr_findCloseEdges” is now renamed to pgr_degree and promoted to official status, it is not immediately clear why both entries are still present.

Please verify whether both entries are needed for backward compatibility or if they should be consolidated (for example, by clearly indicating that pgr_findCloseEdges has been fully renamed to pgr_degree). This change will help prevent any confusion among users.

---

Action Required: Clarify and Consolidate Release Note Entries

The current release notes show two bullet items—one for pgr_degree and one for pgr_findCloseEdges. Since the PR objectives indicate that the function formerly known as pgr_findCloseEdges has been renamed to pgr_degree and promoted to official status, it’s ambiguous why both entries remain. Please verify:

• If backward compatibility is intended: Update the pgr_findCloseEdges entry with an explicit note (e.g., “alias for pgr_degree”) to clearly indicate that it is maintained solely for legacy support.
• If backward compatibility is not required: Remove the pgr_findCloseEdges bullet item, consolidating the documentation under pgr_degree to avoid user confusion.

Please review this with the PR objectives and project standards in mind.

doc/metrics/metrics-family.rst (1)

18-24: Updated Section Markers Reflect Official Status
The old “proposed” markers have been replaced with “official-start” and “official-end,” which correctly reflects the promotion of the underlying functions to official status. This update aligns with both the PR objectives and the long‐term memory guidance regarding retaining historical notes while signaling the current status.

doc/src/routingFunctions.rst (1)

74-79: Integration of the Metrics Family
A new documentation entry for the metrics family has been added here (lines 74–79), including the directive to include the updated “metrics-family.rst” content. This reinforces that pgr_degree is now part of the officially recognized family of metrics functions. The change is clear and consistent with the promotion effort.

NEWS.md (1)

11-29:

❓ Verification inconclusive

Ambiguity in Function Naming and Status
In the News release notes for pgRouting 3.8.0 the following two entries appear in close succession:

• pgr_degree
  – Error messages adjustment.
  – New signature with only Edges SQL.
  – Function promoted to official.

• pgr_findCloseEdges
  – Error messages adjustment.
  – “partial” option is removed.
  – Function promoted to official.

Because the PR objective indicates that pgr_findCloseEdges has been renamed to pgr_degree, the simultaneous presence of both entries may confuse readers. Please verify if these entries should be merged or if additional clarifying text is needed (for example, marking pgr_findCloseEdges as the deprecated name that has been fully replaced by pgr_degree).

---

Clarify Function Naming and Deprecation in NEWS.md

The NEWS release notes currently list both pgr_degree and pgr_findCloseEdges as promoted to official functions. However, since the PR objective indicates that pgr_findCloseEdges has been renamed to pgr_degree, the two entries can cause confusion. Please verify whether to merge these entries into a single note for pgr_degree (consolidating its new signature, error message adjustments, and removal of the “partial” option) or to add a clarifying remark that explicitly marks pgr_findCloseEdges as deprecated in favor of pgr_degree.