python / python/typing

Best Practices document

Abierto
#851 3 comentarios 2 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

topic: documentation
Lenguaje dominante
Python
Estrellas
1.8k
Forks
302
Merge medio
23 h
PR fusionados (30 d)
8

Descripción

  • Built-in generics
  • New union syntax
  • No union return types, use Any or T | Any
  • Discuss Any vs object
  • Callbacks: Use return type object instead of None or Any if the returned value is ignored

Please add anything you think the document should contain.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

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

Comienza con los temas propuestos en este issue y revisa la documentación de tipado existente del repositorio antes de decidir dónde debe ubicarse un documento de buenas prácticas. Confirma las directrices para los genéricos integrados, la sintaxis de uniones, los tipos de retorno, Any frente a object y los callbacks; después, define con los maintainers del proyecto el alcance del documento y los criterios de finalización.

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

Evaluación

Stack tecnológico
python
Área
documentation
Tipo de issue
Documentación
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Necesita aclaración
Aptitud para principiantes
30/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.