What is wrong
The Antora attributes file defines a documentation attribute
hibernate-validator-site, but nothing in the documentation tree ever
references it. An attribute that is never used with {hibernate-validator-site}
in any .adoc page is dead configuration: it adds a line a maintainer has to
reason about while contributing nothing to the rendered docs.
Where
- File:
framework-docs/antora.yml
- Line (advisory): 64
- Occurrence: `hibernate-validator-site: '(hibernate.org/redacted)
Evidence
config_kind: antora_attribute
pattern: hibernate-validator-site
raw_line: hibernate-validator-site: '(hibernate.org/redacted)
value: '(hibernate.org/redacted)
matches_nothing_in_tree: true
names_a_literal: true
extractor (miner): config_dead_entry v1.0.0
score: 75 (config_kind_prior=40, names_a_literal=25, single_line_fix=10, staleness_years=0)
Suggested fix
Remove the unused hibernate-validator-site attribute line. Since no page
references it, removing the definition is the fix. The docs team may prefer to
handle it their own way (for example, if they intend to add a page that uses
it), so treat this as a starting point rather than a prescribed patch.
How to verify the fix
From tools/candidate-miner/, run the miner and confirm this fingerprint is no
longer emitted:
./miner.py run --miner config_dead_entry --dry-run
Provenance
Mined at commit 008199fe0fa0e93ec85a458bf0585445bb97532e.
candidate-miner:fingerprint sha256:7303b7590953cd3fb166236d2e0a7b9ff1a3dd8733d817c34a6c9ed5fa23a54c
Generated by Candidate scan: file mined candidates as issues · opus48 · 86.5 AIC · ⌖ 30.3 AIC · ⊞ 4.7K · ◷
What is wrong
The Antora attributes file defines a documentation attribute
hibernate-validator-site, but nothing in the documentation tree everreferences it. An attribute that is never used with
{hibernate-validator-site}in any
.adocpage is dead configuration: it adds a line a maintainer has toreason about while contributing nothing to the rendered docs.
Where
framework-docs/antora.ymlEvidence
Suggested fix
Remove the unused
hibernate-validator-siteattribute line. Since no pagereferences it, removing the definition is the fix. The docs team may prefer to
handle it their own way (for example, if they intend to add a page that uses
it), so treat this as a starting point rather than a prescribed patch.
How to verify the fix
From
tools/candidate-miner/, run the miner and confirm this fingerprint is nolonger emitted:
Provenance
Mined at commit
008199fe0fa0e93ec85a458bf0585445bb97532e.candidate-miner:fingerprint sha256:7303b7590953cd3fb166236d2e0a7b9ff1a3dd8733d817c34a6c9ed5fa23a54c