Приводите примеры

Один конкретный пример стоит абзаца описания. Если вы хотите вывод в определённой форме, покажите эту форму. Это самый быстрый способ устранить неоднозначность.

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.

Примеры фиксируют именование, структуру и регистр, которые одни слова оставляют расплывчатыми. Когда можете, включайте пример как тест — тогда «сделай так, чтобы тест прошёл» становится однозначной инструкцией. Приём обобщается: образец ответа API фиксирует парсер, пара «до/после» фиксирует рефакторинг, скриншот или ASCII-набросок фиксирует вёрстку. Всякий раз, поймав себя на написании длинного описания некой формы, остановитесь и покажите вместо этого один экземпляр этой формы.