Cung cấp ví dụ
Một ví dụ cụ thể đáng giá bằng cả một đoạn văn mô tả. Nếu bạn muốn đầu ra theo một hình dạng cụ thể, hãy cho xem hình dạng đó. Đây là cách nhanh nhất để loại bỏ sự mơ hồ.
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.
Các ví dụ chốt chặt tên gọi, cấu trúc, và cách viết hoa/thường mà chỉ lời nói không thôi để lại sự mập mờ. Khi có thể, hãy đưa ví dụ vào dưới dạng một bài kiểm thử (test) — khi đó "make the test pass" trở thành một chỉ thị không còn mơ hồ. Mẹo này áp dụng rộng rãi hơn: một phản hồi mẫu từ một (Application Programming Interface — Giao diện lập trình ứng dụng, cách một chương trình yêu cầu dữ liệu từ một chương trình khác) chốt chặt một trình phân tích cú pháp, một cặp trước/sau chốt chặt một lần tái cấu trúc mã (refactor), một ảnh chụp màn hình hay bản phác thảo ASCII chốt chặt một bố cục giao diện. Bất cứ khi nào bạn bắt gặp mình đang viết một mô tả dài về một hình dạng, hãy dừng lại và thay vào đó cho xem một ví dụ cụ thể của hình dạng đó.