phpDocumentor / phpDocumentor/ReflectionDocBlock

Support Annotation-style tags

Abierto
#199 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
PHP
Estrellas
9.4k
Forks
137
Merge medio
4 d 2 h
PR fusionados (30 d)
1

Descripción

Tags like @Route("/anonymization_preset", name="anonymization_preset_") show the part between parenthesis as part of the description. It would be more convenient to make this a first-class citizen as now this conflicts with the rule that descriptions may be parsed as Markdown documents.

See https://github.com/phpDocumentor/phpDocumentor/issues/2081 for more information

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Empieza leyendo este issue y el issue 2081 de phpDocumentor enlazado para aclarar la sintaxis prevista de los tags de estilo Annotation y en qué debe diferir de las descripciones en Markdown. Después, localiza los puntos de entrada del análisis de tags y del procesamiento de descripciones en ReflectionDocBlock; se considera completado cuando la anotación de ejemplo se trata como un first-class tag sin analizarse como parte de la descripción, con cobertura para el nuevo comportamiento.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
php
Área
documentation
Tipo de issue
Nueva funcionalidad
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.