Quy tắc tiêu chuẩn mã hóa kỳ lạ nhất mà bạn buộc phải tuân theo là gì? [đóng cửa]

Khi tôi hỏi câu hỏi này, tôi gần như luôn luôn chắc chắn là bạn nên có các tiêu chuẩn mã hóa.

Quy tắc tiêu chuẩn mã hóa kỳ lạ nhất mà bạn từng bị buộc phải tuân theo là gì?

Và kỳ lạ nhất tôi có nghĩa là hài hước nhất, hoặc tồi tệ nhất, hoặc chỉ đơn giản là kỳ quặc.

Trong mỗi câu trả lời, vui lòng đề cập đến ngôn ngữ nào, quy mô nhóm của bạn là gì và tác động xấu nào gây ra cho bạn và nhóm của bạn.

Tôi ghét nó khi việc sử dụng nhiều lợi nhuận bị cấm.

thụt ngược. Ví dụ:

    for(int i = 0; i < 10; i++)
        {
myFunc();
        }

và:

    if(something)
        {
// do A
        }
    else
        {
// do B
    }

Có thể không phải là thứ kỳ quặc nhất mà bạn sẽ nhận được, nhưng tôi thực sự ghét khi tôi phải mở đầu tên bảng cơ sở dữ liệu bằng 'tbl'

Hầu như bất kỳ loại ký hiệu nào.

Vấn đề với ký hiệu của Cameron là nó rất thường bị hiểu lầm. Ý tưởng ban đầu là tiền tố biến để ý nghĩa rõ ràng. Ví dụ:

int appCount = 0; // Number of apples.
int pearCount = 0; // Number of pears.

Nhưng hầu hết mọi người sử dụng nó để xác định loại.

int iAppleCount = 0; // Number of apples.
int iPearCount = 0;  // Number of pears.

Điều này thật khó hiểu, bởi vì mặc dù cả hai số đều là số nguyên, mọi người đều biết, bạn không thể so sánh táo với lê.

Không có nhà điều hành ternary cho phép nơi tôi hiện đang làm việc:

int value = (a < b) ? a : b;

... bởi vì không phải ai cũng "hiểu được". Nếu bạn nói với tôi, "Đừng sử dụng nó bởi vì chúng tôi đã phải viết lại chúng khi các cấu trúc trở nên quá phức tạp" (các toán tử ternary lồng nhau, có ai không?), Thì tôi đã hiểu. Nhưng khi bạn nói với tôi rằng một số nhà phát triển không hiểu họ ... ừm ... Chắc chắn rồi.

KHÔNG BAO GIỜ xóa bất kỳ mã nào khi thực hiện thay đổi. Chúng tôi đã nói để bình luận tất cả các thay đổi. Hãy nhớ rằng chúng tôi sử dụng kiểm soát nguồn. Chính sách này đã không tồn tại lâu bởi vì các nhà phát triển đã rất phẫn nộ về nó và làm thế nào để làm cho mã không thể đọc được.

Tôi đã từng làm việc dưới sự chuyên chế của Vua VB hùng mạnh .

Các VB vua là bậc thầy tinh khiết của MS Excel và VBA, cũng như cơ sở dữ liệu ( Do đó họ của ông: Ông chơi với Excel trong khi các nhà phát triển làm việc với các trình biên dịch, và thách thức anh ấy trên cơ sở dữ liệu có thể có những ảnh hưởng bất lợi về nghề nghiệp của bạn ... ).

Tất nhiên, các kỹ năng to lớn của anh đã cho anh một tầm nhìn độc đáo về các vấn đề phát triển và giải pháp quản lý dự án: Mặc dù không chính xác theo tiêu chuẩn mã hóa theo nghĩa nghiêm ngặt nhất, VB King thường xuyên có những ý tưởng mới về "tiêu chuẩn mã hóa" và "thực tiễn tốt nhất" mà anh đã thử (và thường đã thành công) để áp đặt chúng tôi. Ví dụ:

• Tất cả các mảng C / C ++ sẽ bắt đầu ở chỉ số 1, thay vì 0. Thật vậy, việc sử dụng 0 làm chỉ mục đầu tiên của một mảng đã lỗi thời và đã được thay thế bởi quản lý chỉ số sâu sắc của Visual Basic 6.

• Tất cả các hàm sẽ trả về mã lỗi: Không có ngoại lệ trong VB6, vậy tại sao chúng ta lại cần chúng? ( tức là trong C ++ )

• Vì "Tất cả các hàm sẽ trả về mã lỗi" là không thực tế đối với các hàm trả về các loại có ý nghĩa, tất cả các hàm sẽ có mã lỗi là tham số [vào / ra] đầu tiên.

• Tất cả mã của chúng tôi sẽ kiểm tra mã lỗi ( điều này dẫn đến trường hợp xấu nhất về VBScript nếu tôi đã thấy trong sự nghiệp của mình ... Tất nhiên, vì các mệnh đề "khác" không bao giờ được xử lý, không có lỗi nào thực sự được tìm thấy cho đến khi quá muộn ).

• Vì chúng tôi đang làm việc với C ++ / COM, bắt đầu từ ngày này, chúng tôi sẽ mã hóa tất cả các chức năng tiện ích DOM của chúng tôi trong Visual Basic.

• Lỗi ASP 115 là xấu. Vì lý do này, chúng tôi sẽ sử dụng On Error Resume Next trong mã VBScript / ASP của chúng tôi để tránh chúng.

• XSL-T là một ngôn ngữ hướng đối tượng. Sử dụng thừa kế để giải quyết vấn đề của bạn ( sự ngạc nhiên ngu ngốc gần như đã phá vỡ hàm của tôi mở ra một ngày này ).

• Các ngoại lệ không được sử dụng, và do đó nên được loại bỏ. Vì lý do này, chúng tôi sẽ bỏ chọn hộp kiểm yêu cầu cuộc gọi hủy trong trường hợp ngoại lệ ( phải mất nhiều ngày để một chuyên gia tìm ra nguyên nhân của tất cả những rò rỉ bộ nhớ đó và anh ta gần như phát điên khi phát hiện ra họ đã sẵn sàng bỏ qua (và ẩn) lưu ý kỹ thuật của anh ấy về việc kiểm tra lại tùy chọn, gửi một số tuần trước đó ).

• nắm bắt tất cả các ngoại lệ trong giao diện COM của các mô-đun COM của chúng tôi và xử lý chúng một cách im lặng ( theo cách này, thay vì gặp sự cố, một mô-đun sẽ chỉ xuất hiện nhanh hơn ... Sáng bóng! ... Khi chúng tôi sử dụng xử lý lỗi über được mô tả ở trên, chúng tôi thậm chí còn mất một thời gian để hiểu điều gì đang thực sự xảy ra ... Bạn không thể có cả tốc độ và kết quả chính xác, phải không? ).

• Bắt đầu từ hôm nay, cơ sở mã của chúng tôi sẽ chia thành bốn nhánh. Chúng tôi sẽ quản lý đồng bộ hóa của họ và tích hợp tất cả các sửa lỗi / tiến hóa bằng tay.

Tất cả trừ các mảng C / C ++ , các hàm tiện ích VB DOM và XSL-T là ngôn ngữ OOP đã được triển khai bất chấp sự phản đối của chúng tôi. Tất nhiên, theo thời gian, một số đã được phát hiện, ahem , bị hỏng và bị bỏ rơi hoàn toàn.

Tất nhiên, uy tín của Vua VB không bao giờ phải chịu vì điều đó: Trong số các quản lý cấp cao hơn, ông vẫn là một chuyên gia kỹ thuật "súng hàng đầu" ...

Điều này tạo ra một số tác dụng phụ thú vị, như bạn có thể thấy bằng cách theo liên kết Nhận xét tốt nhất trong mã nguồn bạn đã từng gặp là gì?

Quay trở lại những năm 80/90, tôi làm việc cho một công ty giả lập máy bay sử dụng FORTRAN. Trình biên dịch FORTRAN của chúng tôi có giới hạn 8 ký tự cho các tên biến. Các tiêu chuẩn mã hóa của công ty dành riêng ba trong số chúng cho thông tin kiểu ký hiệu Hungary. Vì vậy, chúng tôi đã phải thử và tạo các tên biến có ý nghĩa chỉ với 5 ký tự!

Tôi đã làm việc tại một nơi có sự hợp nhất giữa 2 công ty. Người 'thống trị' có một máy chủ chính được viết bằng K & R C (tức là tiền ANSI). Họ đã buộc các nhóm Java (từ cả hai văn phòng - có lẽ tổng cộng 20 nhà phát triển) sử dụng định dạng này, trong đó vui vẻ bỏ qua 2 trụ cột của "cuộc tranh luận cú đúp" và đi thẳng đến điên rồ:

if ( x == y ) 
    {
    System.out.println("this is painful");
    x = 0;
    y++;
    }

Cấm

while (true) {

Được phép:

for (;;) {

một người bạn của tôi - chúng tôi sẽ gọi anh ấy là CodeMonkey - đã nhận được công việc đầu tiên của mình ở trường đại học [ nhiều năm trước] khi làm phát triển nội bộ ở COBOL. Chương trình đầu tiên của anh đã bị từ chối vì 'không tuân thủ các tiêu chuẩn của chúng tôi' vì nó đã sử dụng ... [rùng mình!] Các câu lệnh IF lồng nhau

các tiêu chuẩn mã hóa đã cấm sử dụng các câu lệnh IF lồng nhau

Bây giờ, CodeMonkey không hề ngại ngùng và chắc chắn về khả năng của mình, vì vậy anh ấy đã kiên trì hỏi mọi người về chuỗi và xuống lối đi tại sao quy tắc này tồn tại. Hầu hết tuyên bố họ không biết, một số người bịa ra về 'khả năng đọc' và cuối cùng, một người đã nhớ lý do ban đầu: phiên bản đầu tiên của trình biên dịch COBOL mà họ sử dụng có lỗi và không xử lý chính xác các câu lệnh IF lồng nhau.

Lỗi trình biên dịch này, tất nhiên, đã được sửa trong ít nhất một thập kỷ, nhưng không ai thách thức các tiêu chuẩn . [baaa!]

CodeMonkey đã thành công trong việc thay đổi các tiêu chuẩn - cuối cùng!

Sau khi làm việc trong một dự án, nơi gạch dưới bị cấm. Và tôi có nghĩa là hoàn toàn bị cấm. Vì vậy, trong ứng dụng ac # winforms, bất cứ khi nào chúng tôi thêm trình xử lý sự kiện mới (ví dụ: cho một nút), chúng tôi sẽ phải đổi tên tên phương thức mặc định từ buttonName_Click () thành một cái gì đó khác, chỉ để thỏa mãn cái tôi của anh chàng đã viết mã tiêu chuẩn. Cho đến hôm nay tôi không biết những gì anh ấy đã chống lại gạch dưới khiêm tốn

Hoàn toàn vô dụng quy ước đặt tên cơ sở dữ liệu. Mỗi tên bảng phải bắt đầu bằng một số. Các con số cho thấy loại dữ liệu nào trong bảng.

• 0: dữ liệu được sử dụng ở mọi nơi
• 1: dữ liệu chỉ được sử dụng bởi một mô-đun nhất định
• 2: bảng tra cứu
• 3: lịch, trò chuyện và thư
• 4: đăng nhập

Điều này làm cho nó khó tìm thấy một bảng nếu bạn chỉ biết chữ cái đầu tiên của tên của nó. Ngoài ra - vì đây là cơ sở dữ liệu mssql - chúng tôi phải bao quanh các tablename với dấu ngoặc vuông ở mọi nơi.

-- doesn't work
select * from 0examples;

-- does work
select * from [0examples];

Chúng tôi đang thực hiện một dự án C ++ và trưởng nhóm là một anh chàng Pascal.

Vì vậy, chúng tôi đã có một tiêu chuẩn mã hóa bao gồm tệp để xác định lại tất cả cú pháp C và C ++ phiền phức đó:

#define BEGIN {
#define END }

nhưng xin chờ chút nữa!

#define ENDIF }
#define CASE switch

vv Thật khó để nhớ sau tất cả thời gian này.

Điều này đã lấy những gì có thể là mã C ++ hoàn toàn có thể đọc được và khiến nó trở nên bất khả thi đối với bất kỳ ai ngoại trừ nhóm trưởng.

Chúng tôi cũng đã phải sử dụng ký hiệu Hungary ngược, tức là

MyClass *class_pt  // pt = pointer to type

UINT32 maxHops_u   // u = uint32

Mặc dù kỳ lạ, tôi đã phát triển như thế này.

Tại một công việc trước đây:

• Các bảng "Bình thường" bắt đầu bằng T_
• Các bảng "Hệ thống" (thường là tra cứu) bắt đầu bằng TS_ (trừ khi chúng không hoạt động vì ai đó không cảm thấy như ngày hôm đó)
• Các bảng tham chiếu chéo bắt đầu bằng TSX_
• Tất cả các tên trường bắt đầu bằng F_

Vâng đúng vậy. Tất cả các lĩnh vực, trong mỗi bảng duy nhất. Để chúng ta có thể nói đó là một lĩnh vực.

Một người bạn của tôi gặp phải quy tắc này khi làm việc tại một công việc của chính phủ. Việc sử dụng ++ (trước hoặc sau) đã bị cấm hoàn toàn. Lý do: Trình biên dịch khác nhau có thể giải thích nó khác nhau.

Một nửa của đội ủng hộ thụt bốn không gian; nửa còn lại ủng hộ thụt hai không gian.

Như bạn có thể đoán, tiêu chuẩn mã hóa bắt buộc ba, để "xúc phạm tất cả như nhau" (một trích dẫn trực tiếp).

Không thể sử dụng Reflection vì người quản lý cho rằng nó liên quan đến quá nhiều 'ma thuật'.

Một thứ kỳ lạ nhất mà tôi có, và một thứ khiến tôi mất khá nhiều thời gian để lật đổ, là khi chủ sở hữu công ty chúng tôi yêu cầu sản phẩm mới của chúng tôi chỉ là IE. Nếu nó có thể hoạt động trên FireFox, điều đó không sao, nhưng nó chỉ là IE.

Điều này có vẻ không quá xa lạ, ngoại trừ một lỗ hổng nhỏ. Tất cả các phần mềm dành cho gói phần mềm máy chủ bespoke, chạy trên Linux và tất cả các hộp khách mà khách hàng của chúng tôi mua là Linux. Thiếu cố gắng tìm ra cách để Wine (trong những ngày đó, rất không đáng tin cậy) chạy và chạy trên tất cả các hộp này và xem liệu chúng ta có thể chạy IE và huấn luyện quản trị viên của họ cách gỡ lỗi các vấn đề về Rượu không, điều đó đơn giản là không thể để đáp ứng yêu cầu của chủ sở hữu. Vấn đề là anh ta đang thực hiện thiết kế Web và đơn giản là không biết cách làm cho các trang web tuân thủ FireFox.

Có lẽ bạn sẽ không sốc khi biết rằng công ty chúng tôi đã phá sản.

Sử dụng tên định danh được đánh số chung

Trong công việc hiện tại của tôi, chúng tôi có hai quy tắc thực sự có nghĩa là:

Quy tắc 1: Mỗi lần chúng tôi tạo một trường mới trong bảng cơ sở dữ liệu, chúng tôi phải thêm các trường dự trữ bổ sung để sử dụng trong tương lai. Các trường dự trữ này được đánh số (vì không ai biết họ sẽ giữ dữ liệu nào vào một ngày nào đó) Lần tới khi chúng tôi cần một trường mới, trước tiên chúng tôi sẽ tìm trường dự trữ chưa sử dụng.

Vì vậy, chúng tôi kết thúc với việc customer.reserve_field_14chứa địa chỉ e-mail của khách hàng.

Vào một ngày nọ, ông chủ của chúng tôi nghĩ về việc giới thiệu các bảng dự trữ , nhưng may mắn thay, chúng tôi có thể thuyết phục anh ta không làm điều đó.

Quy tắc 2: Một trong những sản phẩm của chúng tôi được viết bằng VB6 và VB6 có giới hạn tổng số tên định danh khác nhau và vì mã rất lớn, chúng tôi liên tục chạy vào giới hạn này. Là một "giải pháp", tất cả các tên biến cục bộ được đánh số:

• Lvarlong1
• Lvarlong2
• Lvarstr1
• ...

Mặc dù điều đó có hiệu quả phá vỡ giới hạn định danh, hai quy tắc này kết hợp lại dẫn đến mã đẹp như thế này:

...

If Lvarbool1 Then
  Lvarbool2 = True
End If

If Lvarbool2 Or Lvarstr1 <> Lvarstr5 Then
  db.Execute("DELETE FROM customer WHERE " _ 
      & "reserve_field_12 = '" & Lvarstr1 & "'")
End If

...

Bạn có thể tưởng tượng việc sửa mã cũ hoặc người khác khó đến mức nào ...

Cập nhật mới nhất: Bây giờ chúng tôi cũng đang sử dụng "thủ tục dự trữ" cho các thành viên tư nhân:

Private Sub LSub1(Lvarlong1 As Long, Lvarstr1 As String)
  If Lvarlong1 >= 0 Then 
    Lvarbool1 = LFunc1(Lvarstr1)
  Else
    Lvarbool1 = LFunc6()
  End If
  If Lvarbool1 Then
    LSub4 Lvarstr1
  End If
End Sub

EDIT: Có vẻ như mẫu mã này đang ngày càng trở nên phổ biến. Xem bài này Hàng ngày WTF để tìm hiểu thêm: Loạn thị :)

Quay lại những ngày C ++ của tôi, chúng tôi không được phép sử dụng ==,> =, <=, &&, v.v., đã có macro cho ...

if (bob EQ 7 AND alice LEQ 10)
{
   // blah
}

điều này rõ ràng là để đối phó với "sự phân công ngẫu nhiên cũ trong lỗi có điều kiện", tuy nhiên chúng tôi cũng có quy tắc "đặt hằng số trước các biến", vì vậy

if (NULL EQ ptr); //ok
if (ptr EQ NULL); //not ok

Chỉ cần nhớ rằng, tiêu chuẩn mã hóa đơn giản nhất tôi từng nghe là "Viết mã như thể người duy trì tiếp theo là một kẻ tâm thần độc ác biết bạn sống ở đâu".

Ký hiệu Hungary nói chung.

Tôi đã có rất nhiều quy tắc ngu ngốc , nhưng không nhiều điều mà tôi cho là hết sức kỳ lạ.

Điều ngớ ngẩn nhất là trong một công việc của NASA mà tôi đã làm việc vào đầu những năm 90. Đây là một công việc khổng lồ, với hơn 100 nhà phát triển trên đó. Các nhà phát triển có kinh nghiệm đã viết các tiêu chuẩn mã hóa đã quyết định rằng mọi tệp nguồn nên bắt đầu bằng một từ viết tắt gồm bốn chữ cái và chữ cái đầu tiên phải viết tắt cho nhóm chịu trách nhiệm về tệp. Đây có lẽ là một ý tưởng tuyệt vời cho các dự án FORTRAN 77 cũ mà họ đã từng sử dụng.

Tuy nhiên, đây là một dự án Ada , với cấu trúc thư viện phân cấp đẹp, nên không có ý nghĩa gì cả. Mỗi thư mục chứa đầy các tệp bắt đầu bằng cùng một chữ cái, theo sau là 3 ký tự vô nghĩa khác, dấu gạch dưới và sau đó là một phần của tên tệp quan trọng. Tất cả các gói Ada phải bắt đầu với mụn cóc năm ký tự này. Các điều khoản "sử dụng" của Ada cũng không được phép (có thể là điều tốt trong các trường hợp thông thường), do đó, điều đó có nghĩa là bất kỳ tham chiếu nào đến bất kỳ định danh nào không phải là địa phương của tệp nguồn đó cũng phải bao gồm cả mụn cóc vô dụng này. Có lẽ đã có một cuộc nổi dậy về điều này, nhưng toàn bộ dự án đã được các lập trình viên cơ sở và mới từ các nhân viên mới vào đại học (bản thân tôi là người đến sau).

Một tuyên bố chuyển nhượng điển hình (đã dài dòng trong Ada) cuối cùng sẽ trông giống như thế này:

NABC_The_Package_Name.X := NABC_The_Package_Name.X + 
  CXYZ_Some_Other_Package_Name.Delta_X;

May mắn thay, ít nhất họ đã giác ngộ đủ để cho phép chúng tôi hơn 80 cột! Tuy nhiên, mụn cóc ở cơ sở đã bị ghét đến mức nó trở thành mã soạn sẵn ở đầu các tệp nguồn của mọi người để sử dụng "đổi tên" của Ada để loại bỏ mụn cóc. Sẽ có một lần đổi tên cho mỗi gói đã nhập ("đã rút"). Như thế này:

package Package_Name renames NABC_Package_Name;
package Some_Other_Package_Name renames CXYZ_Some_Other_Package_Name;
--// Repeated in this vein for an average of 10 lines or so

Những gì sáng tạo hơn trong số chúng ta đã làm là cố gắng sử dụng mụn cóc để tạo ra một tên gói (hoặc ngớ ngẩn) nhạy cảm. (Tôi biết bạn đang nghĩ gì, nhưng những người thám hiểm không được phép và xấu hổ với bạn! Điều đó thật kinh tởm). Ví dụ, tôi thuộc nhóm mã C ommon và tôi cần tạo một gói để giao tiếp với nhóm W orkstation. Sau một buổi động não với anh chàng Workstation, chúng tôi quyết định đặt tên cho các gói của chúng tôi để ai đó cần cả hai sẽ phải viết:

with CANT_Interface_Package;
with WONT_Interface_Package;

Khi tôi bắt đầu làm việc tại một nơi và bắt đầu nhập mã của mình vào kiểm soát nguồn, sếp của tôi đột nhiên đến gặp tôi và yêu cầu tôi ngừng cam kết rất nhiều. Anh ấy nói với tôi rằng không nên làm hơn 1 lần cam kết mỗi ngày cho một nhà phát triển vì nó chiếm quyền kiểm soát nguồn. Tôi chỉ đơn giản là há hốc miệng với anh ta ...

Sau này tôi hiểu rằng lý do anh ta thậm chí đến gặp tôi là vì máy chủ SVN sẽ gửi cho anh ta (và 10 giám đốc điều hành cao hơn) một thư cho mỗi cam kết mà ai đó đưa ra. Và bằng cách xả rác kiểm soát nguồn, tôi đoán anh ta đã nhắc đến hộp thư của mình.

Thực hiện tất cả các truy vấn cơ sở dữ liệu thông qua các thủ tục được lưu trữ trong Sql Server 2000. Từ các truy vấn đa bảng phức tạp đến các truy vấn đơn giản như:

select id, name from people

Các đối số có lợi cho thủ tục là:

• Hiệu suất
• Bảo vệ
• Bảo trì

Tôi biết rằng chủ đề thủ tục khá gây tranh cãi, vì vậy hãy thoải mái chấm điểm câu trả lời của tôi một cách tiêu cực;)

Phải có 165 bài kiểm tra đơn vị (không nhất thiết phải tự động) trên 1000 dòng mã. Điều đó diễn ra tại một bài kiểm tra cho khoảng 8 dòng.

Không cần phải nói, một số dòng mã khá dài và các hàm trả về con trỏ này để cho phép chuỗi.

Chúng tôi đã phải sắp xếp tất cả các chức năng trong các lớp theo thứ tự abc, để làm cho chúng "dễ tìm hơn". Đừng bận tâm các ide đã thả xuống. Đó là quá nhiều lần nhấp.

(cùng lãnh đạo công nghệ đã viết một ứng dụng để xóa tất cả các nhận xét khỏi mã nguồn của chúng tôi).

Vào năm 1987, tôi đã nhận một công việc với một công ty thuê tôi vì tôi là một trong số ít người biết sử dụng Khải Huyền. Mặc khải, nếu bạn chưa bao giờ nghe về nó, về cơ bản là một triển khai hệ điều hành Pick dựa trên PC - mà nếu bạn chưa bao giờ nghe về nó, có tên từ nhà phát minh của nó, Dick Pick có tên tuyệt vời. Nhiều điều có thể nói về Pick OS, hầu hết đều tốt. Một số nhà cung cấp siêu thị (ít nhất là Prime và MIPS) đã sử dụng Pick hoặc triển khai tùy chỉnh riêng của họ về nó.

Công ty này là một cửa hàng Prime và vì các hệ thống nội bộ của họ, họ đã sử dụng Thông tin. (Không, đó thực sự là tên của nó: đó là triển khai Pick của Prime.) Họ đã ký hợp đồng với nhà nước để xây dựng một hệ thống dựa trên PC, và đã dành khoảng một năm cho dự án Khải Huyền của mình trước khi anh chàng làm tất cả công việc, người cũng là giám đốc MIS của họ, quyết định anh ta không thể làm cả hai công việc nữa và thuê tôi.

Bằng mọi giá, anh ta đã thiết lập một số tiêu chuẩn mã hóa cho phần mềm dựa trên Prime của họ, nhiều trong số đó xuất phát từ hai điều kiện cơ bản: 1) việc sử dụng các thiết bị đầu cuối câm 80 cột và 2) thực tế là vì Prime đã không ' Tôi có một biên tập viên trực quan, anh ấy tự viết. Vì tính di động kỳ diệu của mã Pick, anh ta đã đưa trình soạn thảo của mình xuống Khải Huyền và đã xây dựng toàn bộ dự án trên PC bằng cách sử dụng nó.

Khải, tất nhiên, dựa trên PC, có trình chỉnh sửa toàn màn hình hoàn toàn tốt và không phản đối khi bạn đi qua cột 80. Tuy nhiên, trong vài tháng đầu tiên tôi ở đó, anh ấy đã nhấn mạnh rằng tôi sử dụng trình soạn thảo của anh ấy và tiêu chuẩn của mình.

Vì vậy, tiêu chuẩn đầu tiên là mọi dòng mã phải được bình luận. Mỗi dòng. Không có ngoại lệ. Lý do của ông cho điều đó là ngay cả khi bình luận của bạn nói chính xác những gì bạn vừa viết trong mã, phải bình luận nó có nghĩa là bạn ít nhất đã nghĩ về dòng này hai lần. Ngoài ra, như anh ta vui vẻ chỉ ra, anh ta đã thêm một lệnh vào trình soạn thảo định dạng từng dòng mã để bạn có thể đưa ra nhận xét cuối dòng.

Ồ, vâng. Khi bạn nhận xét mọi dòng mã, đó là với các nhận xét cuối dòng . Nói tóm lại, 64 ký tự đầu tiên của mỗi dòng là mã, sau đó có dấu chấm phẩy và sau đó bạn có 15 ký tự để mô tả 64 ký tự của bạn đã làm gì. Nói tóm lại, chúng tôi đã sử dụng một quy ước ngôn ngữ lắp ráp để định dạng mã Pick / Basic. Điều này dẫn đến những thứ trông như thế này:

EVENT.LIST[DATE.INDEX][-1] = _         ;ADD THE MOST RECENT EVENT
   EVENTS[LEN(EVENTS)]                 ;TO THE END OF EVENT LIST

(Trên thực tế, sau 20 năm cuối cùng tôi đã quên cú pháp tiếp tục dòng của R / Basic, vì vậy nó có thể trông khác. Nhưng bạn hiểu ý.)

Ngoài ra, bất cứ khi nào bạn phải chèn bình luận đa dòng, quy tắc là bạn sử dụng hộp hoa:

************************************************************************
**  IN CASE YOU NEVER HEARD OF ONE, OR COULDN'T GUESS FROM ITS NAME,  **
**  THIS IS A FLOWER BOX.                                             **
************************************************************************

Có, những dấu sao đóng trên mỗi dòng được yêu cầu. Rốt cuộc, nếu bạn sử dụng trình soạn thảo của anh ta, đó chỉ là một lệnh biên tập đơn giản để chèn một hộp hoa.

Khiến anh ấy yên tâm và để tôi sử dụng trình soạn thảo tích hợp của Khải là một trận chiến. Lúc đầu, anh ta khăng khăng, đơn giản vì đó là những quy tắc. Khi tôi phản đối rằng a) Tôi đã biết trình soạn thảo Khải Huyền b) nó thực sự có nhiều chức năng hơn trình soạn thảo của anh ta, c) các nhà phát triển Khải Huyền khác sẽ có cùng quan điểm, anh ta đã vặn lại rằng nếu tôi không đào tạo về trình soạn thảo của anh ta thì tôi sẽ không đã từng có thể làm việc trên cơ sở mã hóa Prime, điều mà cả hai chúng ta đều biết, sẽ không xảy ra chừng nào địa ngục vẫn chưa kết thúc. Cuối cùng anh cũng chịu thua.

Nhưng các tiêu chuẩn mã hóa là cuối cùng để đi. Các bình luận hộp hoa nói riêng là một sự lãng phí thời gian ngu ngốc, và anh ấy đã chiến đấu với tôi bằng răng và nói với họ, nói rằng nếu tôi chỉ sử dụng đúng trình soạn thảo thì việc duy trì chúng sẽ hoàn toàn dễ dàng. (Toàn bộ mọi thứ trở nên khá thụ động, tích cực.) Cuối cùng tôi lặng lẽ nhượng bộ, và từ đó, tất cả các mã tôi mang đến để đánh giá mã đều có những bình luận hộp hoa quý giá của anh ấy.

Một ngày, vài tháng làm việc, khi tôi chứng tỏ bản thân mình có năng lực hơn nhiều (đặc biệt là so với cuộc diễu hành đáng chú ý của các lập trình viên khác đi qua văn phòng đó khi tôi làm việc ở đó), anh ấy nhìn qua vai tôi khi tôi đã làm việc và anh ấy nhận thấy tôi không sử dụng bình luận hộp hoa. Ồ, tôi đã nói, tôi đã viết một trình định dạng mã nguồn chuyển đổi nhận xét của tôi thành phong cách của bạn khi tôi in chúng ra. Nó dễ hơn là duy trì chúng trong trình chỉnh sửa. Anh mở miệng, suy nghĩ một lúc, đóng nó lại, bỏ đi và chúng tôi không bao giờ nói về các tiêu chuẩn mã hóa nữa. Cả hai công việc của chúng tôi trở nên dễ dàng hơn sau đó.

Ở công việc đầu tiên của tôi, tất cả các chương trình C, dù đơn giản hay phức tạp, chỉ có bốn chức năng. Bạn đã có chính, lần lượt gọi ba chức năng khác. Tôi không thể nhớ tên của họ, nhưng chúng là một cái gì đó dọc theo dòng bắt đầu (), middle () và end (). start () đã mở các tệp và kết nối cơ sở dữ liệu, end () đã đóng chúng và middle () đã làm mọi thứ khác . Không cần phải nói, middle () là một hàm rất dài.

Và chỉ để làm cho mọi thứ trở nên tốt hơn, tất cả các biến phải là toàn cầu.

Một trong những ký ức đáng tự hào nhất của tôi về công việc đó là một phần của cuộc nổi dậy chung dẫn đến sự phá hủy các tiêu chuẩn đó.

Một tiêu chuẩn mã hóa C được viết bên ngoài có quy tắc 'không dựa vào quyền ưu tiên của nhà điều hành, luôn luôn sử dụng dấu ngoặc'

Đủ công bằng, mục đích rõ ràng là cấm:

a = 3 + 6 * 2;

theo ý kiến:

a = 3 + (6 * 2);

Điều đó là, điều này đã được thi hành bởi một công cụ tuân theo các quy tắc cú pháp C đó là '=', '==', '.' và truy cập mảng là các toán tử. Vì vậy, mã như:

a[i].x += b[i].y + d - 7;

phải được viết là:

((a[i]).x) += (((b[i]).y + d) - 7);