API ควรอยู่ใน en_US หรือ en_GB หรือทั้งสองอย่าง? [ปิด]


9

ฉันควรเขียน APIs ในการสะกดคำในสหรัฐอเมริกาหรือสะกดอังกฤษหรือไม่ หรือฉันควรจัดทำแผนที่ทั้งคู่ให้เป็นแบบเดี่ยวและภายในโดยใช้ใครก็ตามที่ฉันชอบเพื่อให้ทั้งคู่ทำงานได้ ในปัจจุบัน API ส่วนใหญ่ใช้การสะกดของสหรัฐอเมริกา ทางออกสำหรับมันคืออะไร?

แก้ไข: มีวิธีมาตรฐานนี้ อาจได้รับการสนับสนุนทั้งสอง?

คำตอบ:


15

API สากล

API ที่มีวัตถุประสงค์เพื่อใช้งานระหว่างประเทศ EN-US ดังนั้นหากเจตนาของคุณคือการให้ API ของคุณให้กับนักพัฒนาทั่วโลก (หรืออย่างน้อยหลายประเทศที่อังกฤษไม่นิยมใช้) คุณควรใช้ EN-US

API ท้องถิ่น

แน่นอนว่า API ขนาดเล็กที่กำหนดเป้าหมายไปยังประเทศที่แม่นยำอาจเป็นภาษาของประเทศนี้ แต่ลองคิดดูสองครั้งเกี่ยวกับการใช้ EN-GBแม้ในกรณีนี้:

  • การใช้ชีวิตในฝรั่งเศสฉันจะไม่ขอขอบคุณ API สำหรับภาษาฝรั่งเศสเป็นการส่วนตัว ภาษาอังกฤษนั้นใช้ง่ายกว่าเมื่อพูดถึงเรื่องการพัฒนา การตั้งค่าภาษาทำให้แปลกที่จะเขียนเป็นภาษาท้องถิ่น หากคุณเห็นซอร์สโค้ดพร้อมชื่อวิธีการภาษาจีนเยอรมันหรือรัสเซียคุณจะเข้าใจว่าทำไม สิ่งที่ฉันเห็นอยู่บ่อยครั้งในตอนนี้คือซอร์สโค้ดซึ่งผสมผสานชื่อภาษาฝรั่งเศสด้วยสำเนียง (é, ê, à, ฯลฯ ) ชื่อภาษาฝรั่งเศสที่ไม่มีสำเนียง (ซึ่งผิดอย่างสมบูรณ์และสามารถทำให้เข้าใจผิด), ชื่อภาษาอังกฤษและภาษาอังกฤษที่สะกดผิด) .
  • การใช้ EN-GB อาจทำให้การใช้ API นั้นยากยิ่งขึ้นสำหรับนักพัฒนาชาวอังกฤษ เป็นการยากที่จะจำว่าเราต้องเขียนColorใน C # หรือใน PHP แต่Colourใน API เฉพาะ
  • เมื่อสร้าง API ท้องถิ่นคุณแน่ใจหรือไม่ว่าจะไม่มีชื่อเสียงในระดับนานาชาติในหนึ่งปีสองปีหรือสิบปี

ตกลงจะหันไปใช้ en_US สำหรับการเขียนโปรแกรม

2
One note - ครั้งหนึ่งเคยมีภาษาถิ่นของ Basic ซึ่งใช้คำสำคัญตามตัวอักษรแปลเป็นภาษาฝรั่งเศสแม้ว่าจะมีข้อ จำกัด ASCII ("si" แทนที่จะเป็น "if" เป็นต้น) อาจเป็นสิ่งที่แย่ที่สุดเกี่ยวกับเรื่องนี้คือพื้นฐานไม่ใช่ว่าเป็นภาษาฝรั่งเศส
Steve314

3

ฉันเคยเห็นทั้งคู่ API จาก บริษัท อังกฤษใช้การสะกดคำภาษาอังกฤษแบบอังกฤษ (เช่น "อนุญาต" แทน "อนุญาต") สำหรับการไม่มีคำตอบที่ดีกว่าฉันขอแนะนำให้จับคู่การประชุมที่ใช้บนแพลตฟอร์มเป้าหมาย ตัวอย่างเช่นหากคุณใช้คลาส "Color" แพลตฟอร์มคุณไม่ควรใช้ "Color" ใน API ของคุณ


2
การพูดอย่างเคร่งครัดทั้ง "-ise" และ "-ize" มีความถูกต้องเท่าเทียมกันในภาษาอังกฤษแบบอังกฤษแม้ว่า "-ise" อาจยังเป็นเรื่องธรรมดามากกว่า ปัญหาหนึ่งในฐานะนักพัฒนาชาวอังกฤษคือการจดจำ (และในบางกรณีรู้) ความแตกต่างของการสะกด ด้วยเครื่องมือค้นหาและแทนที่และ / หรือการสร้างใหม่การแก้ไขไม่ควรเป็นเรื่องใหญ่ แต่บางครั้งอาจเป็นไปได้ IIRC API ที่เกี่ยวข้องกับ COM บางตัวมีการสะกดสองครั้งสำหรับหนึ่งฟังก์ชั่นเนื่องจากข้อผิดพลาดในการสะกดคำในเวอร์ชั่นแรก - ความผิดพลาดนั้นไม่สามารถลบได้อย่างสมบูรณ์เนื่องจากเหตุผลด้านความเข้ากันได้
Steve314
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.