phpDocumentor / phpDocumentor/ReflectionDocBlock

Location information for tags

Offen
#87 7 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

help wanted in discussion
Vorherrschende Sprache
PHP
Sterne
9.4k
Forks
137
Ø Merge
4 T. 2 Std.
Gemergte PRs (30 T.)
1

Beschreibung

I am using this package in the open PHP language server, which provides static analysis for any IDE through the open language server protocol. One of these features is "Go to Definition". This is currently implemented for the actual PHP code through nikic's great PHPParser, where every node has a file start/end offset so I can calculate which node the user clicked. It would be nice to have this feature for types in docblock tags like @var too, but the tags don't have any start/end offset data. Would it be possible to add this?

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

In der Issue werden keine Dateien oder Tests genannt. Beginne damit, zu ermitteln, wie @var und andere Docblock-Tags geparst werden, und vergleiche ihre Metadaten mit PHPParser-Knoten. Lege fest, wie Start- und End-Offsets von Tags bereitgestellt werden sollen, und überprüfe anschließend, dass Typ-Tags verwertbare Positionsinformationen liefern, ohne das bestehende Parsing zu beeinträchtigen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
php
Bereich
tooling
Issue-Typ
Feature
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

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