JDK 13+ : Headings should start with `h2` and `h4`

Offen
#208 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Anfängerfreundlichkeit
45/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Veraltet
Tech-Stack
java
Bereich
documentation

Rechercherichtung

Beginne damit, den für JDK 13+ beschriebenen Maven-Javadoc-Fehler zu reproduzieren, und lies JDK-8220379 zu den Regeln für Überschriften. Finde den Einstiegspunkt des Rezepts und die Tests für die Migration der Java-Dokumentation. Als erledigt gilt die Aufgabe, wenn Überschriften für Module, Pakete, Typen und verschachtelte Typen mit h2 beginnen, Überschriften für Member mit h4 beginnen und die Javadoc-Generierung erfolgreich ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

recipe
Headings in documentation comments for all modules, packages and types (including nested types) should begin at <h2>.
Headings in members should begin at <h4>.

Currently, this leads to the following failure:

MavenReportException: Error while generating Javadoc: 
[ERROR] Exit code: 1
[ERROR] /MyClass.java:24: error: unexpected heading used: <H1>, compared to implicit preceding heading: <H1>
[ERROR]  * <h1>My heading</h1>

Changing it to <h2> is enough to fix it

See https://bugs.openjdk.org/browse/JDK-8220379

Vorherrschende Sprache
Java
Sterne
161
Forks
134
Ø Merge
4 Std. 50 Min.
Gemergte PRs (30 T.)
107

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus openrewrite/rewrite-migrate-java

Alle Issues in openrewrite/rewrite-migrate-java

Ähnliche Issues

Weitere Issues zu Java

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.