Chúng ta vẽ đường bằng từ vựng khi đặt tên ở đâu?

Question

Ngày khác, tôi đã xem qua mã của chúng tôi và tôi bắt gặp tên lớp IdempotentObject Tôi không biết điều này có nghĩa là gì vào thời điểm đó nên tôi đã đặt câu hỏi liệu đó có phải là tên được chọn kém không. Tôi phát hiện ra người đã viết nó và hỏi nhà phát triển tại sao anh ta đã đặt tên cho nó quá gây nhầm lẫn. Anh ta rất ngạc nhiên khi tôi không biết nó có ý nghĩa gì và nói với tôi rằng đó là một cái tên được lựa chọn tốt bởi vì đối tượng là Idempotent.

Ở một bên, tôi thấy một lý lẽ để giữ cho nó đơn giản và mọi người đều hiểu mọi thứ đang đọc lúc đầu. Mặt khác, chúng ta có ý tưởng rằng chúng ta nên đặt tên chính xác và nếu bạn không biết ý nghĩa của nó.

Cái nào tốt hơn, chính xác hoặc dễ hiểu hơn?

Answer 1

Không vi phạm, nhưng bất kỳ ai có bằng CS hoặc những người hy vọng thực hành trong lĩnh vực này sẽ nhận ra thuật ngữ "Idempotent" có ý nghĩa cụ thể trong khoa học máy tính ngay cả khi bạn không biết thuật ngữ và phải tìm kiếm lên.

Mặt khác, tôi không nghĩ rằng các đối tượng nên có từ "Đối tượng" trong tên - đó là dư thừa.

Bây giờ, nếu nó được gọi là "IdempotentDataAccessor" hoặc một cái gì đó vừa chính xác vừa mang tính mô tả, thì sẽ tốt.

Answer 2

Chính xác là quan trọng hơn. Nhà phát triển ban đầu hoặc bạn có thể đã để lại nhận xét sau đó để giải thích cách đặt tên nếu đó không phải là thuật ngữ có thể dễ dàng tìm thấy trong từ điển hoặc thường được biết đến với khán giả.

Answer 3

Tôi khuyên bạn nên hạn chế tên thành tên miền nằm trong miền của vấn đề. Idempotent sẽ được chấp nhận cho một ứng dụng toán học cấp cao. Tôi muốn sử dụng tên khác nếu đây là một ứng dụng kế toán.

Nhận xét có thể hữu ích trong một số trường hợp, nhưng tôi muốn thay đổi tên.

Answer 4

Vâng, điều đó rất chủ quan. Có lẽ đối với người đã viết tên lớp thì rất dễ hiểu. Rất khó để xác định từ vựng nào là dễ hiểu hoặc khó hiểu vì những người đọc mã có thể có nhiều nền tảng khác nhau.

Answer 5

"Tôi không biết điều này có nghĩa là tại thời điểm vì vậy tôi đã quyết định rằng đó là tên được chọn kém."

Có vấn đề của bạn. Nếu bạn không biết điều gì đó có nghĩa là câu trả lời chính xác là để tìm hiểu.

Answer 6

Tôi không thể nghĩ ra bất kỳ cách súc tích nào khác để mô tả tính ngẫu nhiên. Tôi không nghĩ rằng đây là một vấn đề, vì idempotence là một thuật ngữ rất thường xuyên được sử dụng trong các giao diện RESTful, và các mô tả rõ ràng rất dễ tìm trong một tìm kiếm của Google.

Answer 7

Là nhà phát triển bạn thường thấy mã, hãy chú ý đến một tính năng của một ngôn ngữ hoặc thư viện mà bạn không quen thuộc, tìm kiếm và kết hợp nó vào việc sử dụng ngôn ngữ đó.

Điều này không khác gì.

Bạn không ép buộc người khác tránh các tính năng ít được biết đến của C#, tại sao bạn làm như vậy cho tiếng Anh hoặc bất kỳ ngôn ngữ nào khác?

Tra cứu nó, tìm hiểu nó. Cho dù bạn sử dụng nó là tùy thuộc vào bạn, nhưng xin vui lòng không hạn chế sử dụng của người khác. Bạn có một tham chiếu.

-Adam