phpDocumentor / phpDocumentor/ReflectionDocBlock

Location information for tags

Đang mở
#87 7 bình luận 2 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

help wanted in discussion
Ngôn ngữ chính
PHP
Star
9.4k
Fork
137
Merge trung bình
4 ngày 2 giờ
Pull request đã merge (30 ngày)
1

Mô tả

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?

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Issue không nêu tên tệp hoặc bài kiểm thử nào. Hãy bắt đầu bằng việc xác định cách @var và các thẻ docblock khác được phân tích, rồi so sánh siêu dữ liệu của chúng với các node của PHPParser. Xác định cách các offset bắt đầu và kết thúc của thẻ cần được cung cấp, sau đó kiểm tra rằng các thẻ kiểu cung cấp thông tin vị trí có thể sử dụng mà không làm hỏng việc phân tích hiện có.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
php
Lĩnh vực
tooling
Loại issue
Tính năng
Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.