Sugerencias
Cómo los lectores proponen mejoras a los packs y cómo los propietarios las resuelven.
Una sugerencia es una propuesta de mejora basada en texto para un flujo de trabajo o paquete de contexto. Cualquiera que pueda leer un paquete puede sugerir un cambio; el dueño del pack lo revisa y lo resuelve. Las sugerencias nunca editan el paquete directamente: el cambio propuesto se encuentra en el texto de la sugerencia y el propietario lo aplica mediante una actualización normal del paquete.
Las sugerencias están independientes del contenido del paquete. Permiten a los colaboradores y miembros de la comunidad mejorar un paquete sin acceso de escritura, mientras el propietario mantiene el control de lo que realmente cambia.
Ciclo de vida
Cada sugerencia tiene un status.
| Estado | Significado | Establecido por |
|---|---|---|
open |
Presentado, a la espera de decisión del propietario (estado inicial). | Autor (crear) |
applied |
El propietario lo aceptó; el cambio ha sido realizado. | Propietario (resolver) |
declined |
El propietario decidió no actuar al respecto. | Propietario (resolver) |
archived |
Reserva sin tomar una decisión para mantener limpia la bandeja de entrada. | Propietario (resolver) |
Una sugerencia inicia open. El propietario lo mueve a applied, declined o archived y puede volver a moverlo a open. Resolver una sugerencia sólo cambia su estado; la edición del paquete real es una actualización del paquete separada.
Instantánea
Cuando se crea una sugerencia, el contenido del paquete en ese momento se captura como una instantánea inmutable. La sugerencia permanece anclada a lo que el autor realmente vio, incluso si el paquete cambia posteriormente. Las API de lectura omiten la instantánea de forma predeterminada; solicítelo explícitamente cuando necesite compararlo con el estado actual del paquete.
Listar vs obtener
Las sugerencias de listado devuelven el content de cada uno como una vista previa truncada, el mismo uso de los paquetes de patrones de búsqueda selectiva (primero el esquema, el contenido completo a pedido). Obtenga una sola sugerencia para leer su contenido completo. En la web, las listas de sugerencias enlazan con una página de detalles que carga el contenido completo.
Permisos
| Acción | Quien |
|---|---|
| Crear | Cualquiera que pueda leer el paquete (privado o público). |
| Actualización (título/contenido) | El autor únicamente. |
| Resolver (estado) | Sólo el propietario del paquete. |
| Obtener / listar | Cualquier persona cuyo acceso conceda lea la sugerencia. |
Crear una sugerencia cuesta 5 créditos y publicarla cuesta 2 créditos; leer, actualizar y resolver cuesta 1 crédito cada uno. Cada cuenta también puede crear como máximo 20 sugerencias por día.
Cuándo usar
- Proponer una solución o una adición a un paquete público que no es de su propiedad.
- Brinde comentarios a un compañero de equipo sobre un flujo de trabajo compartido sin editarlo usted mismo.
- Recopile ideas de mejora para un paquete que mantiene en una bandeja de entrada y luego aplique las buenas.
Utilice una sugerencia cuando desee recomendar un cambio; use una actualización de paquete cuando sea propietario del paquete y esté realizando el cambio.