Proporciona ejemplos
Un ejemplo concreto vale más que un párrafo de descripción. Si quieres un resultado con una forma particular, muestra la forma. Esta es la manera más rápida de eliminar la ambigüedad.
Format the data nicely.
Transform this array of users into a summary object.
Input:
[{ name: "Ann", role: "admin" }, { name: "Bo", role: "user" }]
Desired output:
{ total: 2, byRole: { admin: ["Ann"], user: ["Bo"] } }
Write the transform function and a test matching this example.
Los ejemplos fijan la nomenclatura, la estructura y el formato de mayúsculas/minúsculas que las palabras solas dejan borrosos. Cuando puedas, incluye el ejemplo como una prueba (test); así "haz que la prueba pase" se convierte en una instrucción inequívoca. El truco se generaliza: una respuesta de muestra de una (Application Programming Interface — Interfaz de Programación de Aplicaciones, la forma en que un programa solicita datos a otro) fija un analizador, un par antes/después fija una refactorización, una captura de pantalla o un boceto en ASCII (código estándar de caracteres) fija un diseño. Cada vez que te sorprendas escribiendo una larga descripción de una forma, detente y muestra una instancia de esa forma en su lugar.