Câu hỏi được gắn thẻ «comments»

Rất nhiều người cho rằng "các bình luận nên giải thích" tại sao ", nhưng không phải" làm thế nào "". Những người khác nói rằng "mã nên tự viết tài liệu" và ý kiến ​​nên khan hiếm. Robert C. Martin tuyên bố rằng (thường đọc lại lời của tôi) …

236 programming-practices  documentation  comments 

Một trong những thành viên trong nhóm của tôi luôn tránh đưa ra nhận xét trong mã của anh ấy. Mã của anh ấy không phải là tài liệu tự, và các lập trình viên khác gặp khó khăn trong việc hiểu mã của anh ấy. Tôi đã yêu cầu …

183 teamwork  team  comments 

Tôi đã làm việc trong các cửa hàng sản xuất phần mềm quan trọng trong cuộc sống và tôi đã xử lý các quy tắc nhận xét nhằm giữ cho mã có thể đọc được và có khả năng cứu sống. Theo kinh nghiệm của tôi, mặc dù yêu cầu …

142 coding-standards  comments  standards  naming-standards  standardization 

Một đồng nghiệp của tôi tin rằng bất kỳ việc sử dụng nhận xét trong mã nào (nghĩa là không phải phương thức kiểu javadoc hoặc nhận xét lớp) là mùi mã . Bạn nghĩ sao?

100 comments  anti-patterns 

nhà phát triển cơ sở ở đây. Tôi hiện đang làm việc một mình trên một ứng dụng web cho một khách hàng lớn của công ty tôi. Tôi đã bắt đầu vào tháng trước. Khách hàng muốn có ít nhất 25% ý kiến ​​trong mỗi dự án phần mềm …

96 project-management  comments  client-relations  hierarchy 

Tôi đang làm việc trên một dự án khá lớn và có nhiệm vụ thực hiện một số bản dịch cho nó. Có hàng tấn nhãn chưa được dịch và trong khi tôi đang tìm hiểu mã, tôi đã tìm thấy đoạn mã nhỏ này //TODO translations Điều này khiến …

86 documentation  comments 

Tôi đang có một số cuộc thảo luận với các đồng nghiệp mới của tôi về việc bình luận. Cả hai chúng tôi đều thích Clean Code , và tôi hoàn toàn ổn với thực tế là nên tránh các bình luận mã nội tuyến và tên lớp và phương …

83 comments  clean-code 

Tôi đã viết đoạn mã sau: if (boutique == null) { boutique = new Boutique(); boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); boutique.setUrlBoutique(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getUrl()); boutique.setNom(fluxBoutique.getNom()); boutique.setSelected(false); boutique.setIdWebSC(fluxBoutique.getId()); boutique.setDateModification(new Date()); boutiqueDao.persist(boutique); } else { boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); boutique.setUrlBoutique(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getUrl()); boutique.setNom(fluxBoutique.getNom()); //boutique.setSelected(false); boutique.setIdWebSC(fluxBoutique.getId()); boutique.setDateModification(new Date()); boutiqueDao.merge(boutique); } Có một dòng nhận xét ở đây. Nhưng tôi nghĩ rằng nó làm …

83 documentation  comments 

Trước hết, trong câu hỏi này, tôi muốn tránh xa cuộc bút chiến về việc nhận xét mã nguồn là tốt hay xấu. Tôi chỉ đang cố gắng để hiểu rõ hơn ý nghĩa của mọi người khi họ nói về những bình luận cho bạn biết TẠI SAO, CÁI …

78 documentation  comments 

Tôi biết rằng Subversion (những gì chúng tôi đang sử dụng tại nơi làm việc) có thể được định cấu hình để yêu cầu nhận xét về các cam kết, tuy nhiên tôi không ở vị trí quyền lực để đơn giản bật tính năng này. Tôi biết rằng tôi …

78 version-control  comments 

Tôi đang được ông chủ của tôi dạy (tôi vừa học xong và anh ấy muốn một người có ít kinh nghiệm lập trình, vì vậy anh ấy đã chọn tôi đào tạo tôi về những gì công ty đó chuyên về) và bắt đầu làm việc với các ứng …

72 comments 

Mọi người thường có ý nghĩa gì bất cứ khi nào bạn nhìn thấy XXXtrong một bình luận. Thỉnh thoảng, tôi sẽ thấy một bình luận như thế này: # XXX - This widget really should frobulate the whatsit Tất nhiên, tôi có thể cho biết ý kiến ​​có nghĩa …

72 comments  coding-standards 

Tôi chỉ thấy mình viết bình luận sau đây trong một số mã (cổ xưa Visual Basic 6.0) mà tôi đang viết: If WindowState <> 1 Then 'The form's not minimized, so we can resize it safely '... End if Tôi không chắc tại sao tôi vô thức sử dụng …

63 comments  coding-standards 

Lý lịch Tôi đang làm việc trong một nhóm đang tìm cách triển khai các triển khai không thời gian chết. Chúng tôi đang lên kế hoạch sử dụng chiến lược triển khai xanh / xanh để đạt được điều này. Một trong những điều tôi nhận ra khi thực …

51 continuous-integration  deployment  comments  continuous-delivery 

Ai đó đã từng nói rằng chúng ta nên thêm tiền tố vào tất cả các phương thức của mình bằng các /// <summary>khối nhận xét (C #) nhưng không giải thích lý do. Tôi bắt đầu sử dụng chúng và thấy chúng làm phiền tôi khá nhiều, vì vậy …

49 c#  comments