python / python/typing

Update reference/generics.html with PEP695 type parameter syntax

Abierto Apto para principiantes
#2,227 2 comentarios 0 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

The typing documentation for generics is somewhat inconsistent in the use of new syntax:

Are there any plans on updating reference/generics.html? It is a bit confusing for someone who is using Python 3.12 or newer to see out-of-date information.

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 reference/generics.html y compara sus indicaciones sobre genéricos con spec/generics.html, especialmente el material sobre PEP 695 y la sintaxis class Foo[T]. Actualiza la página de referencia para que su tratamiento de la sintaxis genérica sea coherente con la especificación y, después, revisa la documentación renderizada para comprobar que los ejemplos y la redacción coincidan.

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
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Tranquilo
Claridad
Bien especificado
Aptitud para principiantes
76/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.