II. Kỹ nghệ phần mềm
3 Phong cỏch lập trỡnh
Phong cỏch lập trỡnh bao hàm một triết lớ về lập trỡnh, nhấn mạnh tới tớnh đơn giản và rừ ràng. Cỏc yếu tố của phong cỏch lập trỡnh bao gồm tài liệu (mức chương trỡnh gốc) bờn trong, phương phỏp khai bỏo dữ liệu, xõy dựng cõu lệnh, vào/ra.
Tài liệu bờn trong của chương trỡnh gốc bắt đầu với việc chọn lựa cỏc cỏc tờn gọi định danh (biến và nhón), vị trớ và thành phần của việc chỳ thớch, và cỏch tổ chức trực quan của chương trỡnh.
Việc lựa chọn cỏc tờn gọi định danh/tờn chớnh là điều kiện chủ chốt cho việc hiểu chương trỡnh. Những ngụn ngữ gịới hạn tờn biến hay nhón chỉ trong vài kớ tự tự nú đó mang ý nghĩa mơ hồ. Cho dự một chương trỡnh nhỏ thỡ một tờn gọi cú nghĩa cũng làm tăng tớnh dễ hiểu. Theo ngụn từ của mụ hỡnh cỳ phỏp/ngữ nghió, tờn cú ý nghĩa làm "đơn giản việc chuyển đổi từ cỳ phỏp chương trỡnh sang cấu trỳc ngữ nghĩa bờn trong".
Rừ ràng là: phần mềm phải chứa tài liệu bờn trong. Lời chỳ thớch cung cấp cho người phỏt triển một phương tiện truyền thụng với cỏc độc giả khỏc về chương trỡnh gốc. Lời chỳ thớch cú thể cung cấp một hướng dẫn rừ ràng dễ hiểu trong pha cuối cựng của kỹ nghệ phần mềm là bảo trỡ.
Cú nhiều hướng dẫn đó được đề nghị cho việc viết lời chỳ thớch. Cỏc chỳ thớch mở đầu và chỳ thớch chức năng là hai thành phần đũi hỏi cỏch tiếp cận khỏc nhau:
Lời chỳ thớch mở đầu nờn xuất hiện ở ngay đầu của mọi modul. Định dạng cho lời chỳ thớch như sau: