Colabora con la wiki
Una explicación clara puede ahorrar muchas pruebas a otra persona. Puedes ayudar a completar las descripciones que faltan, mejorar su redacción o señalar un error.
Propón una descripción desde su ficha
Sección titulada «Propón una descripción desde su ficha»- Abre la variante exacta en la referencia CKS.
- Pulsa Proponer una descripción mejor. El formulario parte de la descripción publicada, si existe.
- Escribe tu propuesta en español o inglés. Puedes enviarla de forma anónima o indicar un nombre.
- Pulsa Enviar propuesta. La ventana se cierra cuando el buzón confirma la recepción.
Las propuestas llegan a un buzón privado. Upercat las revisa antes de incorporarlas a la documentación. No necesitas una cuenta de GitHub y tu propuesta no se publica automáticamente.
Si cancelas, el borrador se descarta. Al volver a abrir el formulario aparece la descripción publicada. Si falla el envío, el texto permanece en la ventana para que puedas conservarlo y reintentarlo.
Qué hace útil una descripción
Sección titulada «Qué hace útil una descripción»- Explica qué hace la variante exacta, qué recibe y qué devuelve, hasta donde lo sepas.
- Conserva las condiciones, los casos límite y las advertencias que afecten a su uso.
- Si un dato es una suposición, indícalo. El nombre de una función por sí solo no demuestra su comportamiento.
- No incluyas datos personales en el texto. El nombre del autor es opcional.
Las entradas sin descripción son especialmente importantes. Puedes encontrarlas con el filtro «Por describir» del explorador.
Protección del buzón
Sección titulada «Protección del buzón»Hay límites de envío y tiempos de espera progresivos para reducir el abuso. Si alcanzas el límite, el formulario muestra cuánto debes esperar. Una propuesta enviada queda pendiente de revisión; no cambia la ficha por sí misma.
Otras formas de colaborar
Sección titulada «Otras formas de colaborar»Para cambios en la extensión o una conversación técnica más amplia, también puedes usar el repositorio de la extensión CKS. Consulta los créditos y herramientas.