ฉันควรเขียนข้อกำหนดทางไวยากรณ์อะไรบ้าง


21

ขณะนี้เรากำลังเขียนข้อมูลจำเพาะหน้าที่และเทคนิคในรูปแบบสองคอลัมน์ ประโยคสรุปและรายละเอียดทางเทคนิค รายละเอียดมักจะอ้างถึงภาคผนวกที่มีไดอะแกรมการออกแบบเลย์เอาต์และอื่น ๆ

อย่างไรก็ตามฉันกำลังดิ้นรนกับสิ่งที่เครียดที่จะเขียนใน:

ด้วยอดีตกาลราวกับว่างานเสร็จสิ้นฉันพยายามแสดงส่วนขยายไฮไลต์ของการออกจากงาน ในอนาคตกาลในขณะที่มันต้องทำ X เริ่มเสียงเหมือนรายการที่ต้องทำหรือ Tense เป็นกลางยากมากเพราะมันจะต้องทำหรือจะทำ

หากต้องการเพิ่มความสับสนเพิ่มเติมข้อกำหนดนี้อาจอ่านได้โดยผู้ที่ไม่มีภาษาอังกฤษเป็นภาษาแรก

คำตอบ:


12

เรามีสิ่งเหล่านี้มากมายในที่ทำงานสุดท้ายของฉัน

ผู้จัดการผลิตภัณฑ์ได้เลือกใช้กาลปัจจุบันเพื่ออธิบายสิ่งที่ต้องทำเช่น:

ผู้ใช้ส่งคำสั่งซื้อ ระบบจะส่งข้อความยืนยัน

น่าเสียดายที่คำอธิบายของเงื่อนไขเบื้องต้นได้ทำในกาลปัจจุบันเช่น:

ผู้ใช้ใส่รายการลงในตะกร้าสินค้าและระบุปริมาณ

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


ดังนั้น:

  • ใช้กาลปัจจุบันสำหรับสิ่งที่มีอยู่แล้ว

  • ใช้กาลอนาคตสำหรับสิ่งที่ต้องทำ จ้างโลก "ควร", "ต้อง", "จะ"


ขั้นตอนสำคัญในการจำคือการทบทวนข้อมูลจำเพาะ ให้แน่ใจว่าได้อัปเดตข้อความจากอนาคตเป็นปัจจุบันเมื่อดำเนินการเสร็จ
เบ็น L

@BenL: ไม่ผิด กาลจะใช้สำหรับวิธีการให้การใช้งานที่ถูกต้องไม่ระบุสถานะของการดำเนินการ ในที่นี้กาลอนาคตใช้เพื่อระบุสถานะแอปพลิเคชันในอนาคตไม่ใช่สถานะการนำไปใช้ในอนาคต นอกจากนี้ยังเป็นที่น่าสังเกตว่าวิธีการสนับสนุนที่นี่ถูกใช้โดย RFCs ส่วนใหญ่ ดูRFC 2119สำหรับการอภิปรายของข้อกำหนด / ต้อง / จะ (ไม่) ควร / แนะนำ (ไม่) และ / อาจ / ไม่จำเป็น
Brian

5

กาลปัจจุบันดูเหมือนจะดีสำหรับฉัน

  1. เงื่อนไขเบื้องต้น: Foo อยู่ในสถานะ X
  2. การทำงาน: สิ่งนี้และสิ่งที่เกิดขึ้น
  3. Postcondition: Foo อยู่ในสถานะ Y

ทั้งหมดเหล่านี้อยู่ในกาลปัจจุบัน

หรือถ้ามันเป็น "สถานะของโครงการ"

  1. เวอร์ชัน 10: มีคุณสมบัติ A, B, C และ D

  2. เวอร์ชัน 10.1: มีการปรับปรุงเป็น A. แก้ไขข้อผิดพลาด 1,049 ใน B. เพิ่มคุณสมบัติใหม่ E


3

คุณอาจต้องการที่จะรู้ว่าการเขียน RFC คืออะไร

นี่คือRFC 2119: คำสำคัญสำหรับการใช้งานใน RFCs จะบ่งบอกถึงระดับความต้องการ


3
คำถามนี้ถามคำถามนี้อย่างไร
ริ้น

1
นอกจากนี้นี่เป็นคำตอบสำหรับลิงค์เท่านั้น
Kromster กล่าวสนับสนุน Monica


1

เมื่อฉันสร้างการออกแบบสำหรับซอฟต์แวร์ฉันชอบกาลปัจจุบันแม้ว่าฉันจะสร้างการออกแบบก่อนที่ซอฟต์แวร์จะมีอยู่ แม้หลังจากการประยุกต์ใช้ซอฟต์แวร์จากการออกแบบการออกแบบยังคงเกี่ยวข้องและเป็นเอกสารสำคัญ อาจเป็นไปได้ว่าเอกสารการออกแบบอาจยังคงเกี่ยวข้องเป็นระยะเวลานานหลังจากที่มีการใช้งานซอฟต์แวร์มากกว่าก่อนนำไปใช้งาน

โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.