enchant_broker_*: document the ValueError and fix the return types
Los mantenedores suelen responder en 1 día
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 82/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- php, xml
- Área
- documentation
Línea de trabajo
Empieza con las páginas reference/enchant/functions/enchant-broker-*.xml y compara sus tipos de retorno y la documentación de errores con las páginas relacionadas enchant_dict_* en #5935. Documenta los casos indicados de ValueError y Error, incluidos los casos de tag vacío, y actualiza los tipos de retorno a EnchantBroker y EnchantDictionary; el trabajo estará terminado cuando esas páginas describan correctamente las excepciones y los tipos de retorno.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Affected page
reference/enchant/functions/enchant-broker-*.xml
Current issue
The enchant_broker_* pages don't document the ValueError thrown for an unusable EnchantBroker (new EnchantBroker(), or after enchant_broker_free()). enchant_broker_init, enchant_broker_request_dict and enchant_broker_request_pwl_dict still describe a resource as return value.
Suggested improvement
Add an errors section (ValueError for an invalid broker, plus the Error of enchant_broker_free with open dictionaries and the empty tag cases), and return EnchantBroker / EnchantDictionary instances.
Additional context (optional)
Same as #5935 for enchant_dict_*. Checked on PHP 8.4 and 8.5.
- Lenguaje dominante
- XML
- Estrellas
- 600
- Forks
- 903
- Merge medio
- 1 d 5 h
- PR fusionados (30 d)
- 81
Preparar el entorno
Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de php/doc-en
-
session_write_close: the return value is not success or failurePosiblemente ocupada @qodelicious la tomó hoy. Abiertobug good first issue
Dificultad 1/5 Menos de una hora Aptitud para principiantes 91/100
Los mantenedores suelen responder en 1 día
-
socket_accept: wrong statements about socket_set_blocking, false and socket_last_errorPosiblemente ocupada @qodelicious la tomó hoy. Abiertobug
Dificultad 1/5 1-3 horas Aptitud para principiantes 89/100
Los mantenedores suelen responder en 1 día
-
SID is deprecatedPosiblemente ocupada @jordikroon la tomó hace 8 días. Abiertobug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
php/doc-en#5937 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
enchant_dict_*: document the ValueError and fix the return valuesPosiblemente ocupada @qodelicious la tomó hace 2 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
Los mantenedores suelen responder en 1 día
Todos los issues de php/doc-en
Issues similares
-
AGENTS.md: library list omits checkpoint-conformance and describes sdk-js as a live JS SDKPosiblemente ocupada @Naeemeh146 la tomó hoy. Abiertoexternal
Dificultad 1/5 1-3 horas Aptitud para principiantes 82/100
langchain-ai/langgraph#9388 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
documentation help wanted
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
piskyRpapalo/preceptoros-web#231 ·
Los mantenedores suelen responder en 1 día
-
area: assistant area: connections documentation
Dificultad 1/5 Menos de una hora Aptitud para principiantes 91/100
Los mantenedores suelen responder en 1 día
-
lane:gh-3
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
LLM-4-People/bridlewise-testing#100 ·
Los mantenedores suelen responder en 1 día
-
type/bug type/docs type/enhancement
Dificultad 1/5 Menos de una hora Aptitud para principiantes 86/100
Redo-San/RedoSan-Authenticity#574 ·
Los mantenedores suelen responder en 1 día