Aliki: Hard to discern method blocks visually

Offen
#1,573 2 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
ruby

Rechercherichtung

Beginne damit, die gemeldete Methodendokumentation und die rechte Seitenleiste in von RDoc generiertem HTML nachzubilden, wobei die Screenshots als visuelle Referenz dienen. Verfolge, wie Methodennamen, Args- und Description-Einträge gerendert werden, und identifiziere die relevanten Templates oder Styles. Als abgeschlossen gilt die Aufgabe, wenn Methodengrenzen visuell klar sind und die Einträge in der Seitenleiste angeben, zu welcher Methode sie gehören.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

I find it really hard to see where a method documentation starts and ends:

Image

The headers "Args" and "Description" are much bigger than the method name although they are subordinate to it. This means when scrolling through the page it is hard - at least for me - to discern the part that belongs to a method.

I'm not sure whether this is the same problem but the right side bar is also quite useless in this case:

Image

It is just a list of "Args" and "Description" entries without a hint for what.

Vorherrschende Sprache
Ruby
Sterne
928
Forks
471
Ø Merge
2 T. 4 Min.
Gemergte PRs (30 T.)
13

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 ruby/rdoc

Alle Issues in ruby/rdoc

Ähnliche Issues

Weitere Issues zu Ruby

Neue Issues direkt in Ihr Postfach

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