phpDocumentor / phpDocumentor/ReflectionDocBlock

Location information for tags

Ouverte
#87 7 commentaires 2 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

help wanted in discussion
Langage dominant
PHP
Étoiles
9.4k
Forks
137
Merge moyen
4 j 2 h
PR mergées (30 j)
1

Description

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?

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Aucun fichier ni test n’est nommé dans l’issue. Commencez par déterminer comment @var et les autres tags de docblock sont analysés, puis comparez leurs métadonnées avec les nœuds de PHPParser. Définissez comment les offsets de début et de fin des tags doivent être exposés, puis vérifiez que les tags de type fournissent des informations de localisation utilisables sans perturber l’analyse existante.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
php
Domaine
tooling
Type d'issue
Fonctionnalité
Difficulté
4/5
Temps estimé
3-5 jours
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.