«naming-standards» etiketlenmiş sorular

17
Netlik için kodlama standardı: Her kod satırına yorum yapın.
Hayata kritik bir yazılım üreten dükkanlarda çalıştım ve kodu okunaklı ve potansiyel olarak hayat kurtarmayı amaçlayan yorum kuralları ile uğraştım. Tecrübelerime göre, gereksinim bir kontrol listesinden atılmak için bir beyin ölümü angaryası haline geliyor ve anlaşılabilir kod yazmaya odaklanmama yardımcı olmuyor. Ayrıca, hakem değerlendirmecilerimin kodun anlaşılmasını nasıl kolaylaştıracağı konusunda benimle …

2
Python dosya isimlendirme kuralı?
PEP-8'in bu bölümünü gördüm. Https://www.python.org/dev/peps/pep-0008/#package-and-module-names Bunun bir modül / sınıf / paketin dosya adını ifade edip etmediği konusunda net değilim. Her birine bir örneğim varsa, dosya isimleri uygunsa alt çizgi halinde küçük harf mi olmalı? Veya başka bir şey?

8
Adlandırma sorunları: “Bir şeyler”, “Bir şeyler” olarak yeniden adlandırılmalı mıdır? [kapalı]
Bob Amca'nın Temiz Koddaki isimler hakkındaki bölümü , çoğunlukla Macarca notaları ile ilgili olan isimlerdeki kodlamalardan kaçınmanızı önerir. Ayrıca Iöneki arayüzlerden kaldırmayı da belirtiyor , ancak bunun örneklerini göstermiyor. Aşağıdakileri varsayalım: Arayüz kullanımı temel olarak bağımlılık enjeksiyonuyla test edilebilirliği sağlamaktır. Çoğu durumda, bu tek bir uygulayıcı ile tek bir arayüze …

1
Swift Protokolü Adlandırma Kuralları [kapalı]
Temel olarak c # arka planından gelince, ben davranış tanımlayan bir uygulama içermeyen bir nesneyi tanımlamak için "arayüz" terimini kullanmaya alışkınım. C # 'da, arabirim isimleri "I" ile olduğu gibi IEnumerable, vb. Şekilde hazırlamaktır . Tabii ki, kavram farklı dillerde farklı isimler var. Swift'de aynı konsepte "protokol" denir. Protokoller geliştirirken, …


9
Hem görevi gerçekleştiren hem de bir boole durumunu durum olarak döndüren bir yönteme nasıl ad verilir?
Bir yöntem varsa bool DoStuff() { try { // doing stuff... return true; } catch (SomeSpecificException ex) { return false; } } daha çok aranmalı IsStuffDone()mı? Her iki isim de kullanıcı tarafından yanlış yorumlanabilir: Eğer isim buysa, DoStuff()neden bir boole döndürüyor? Adı IsStuffDone()açıksa, yöntemin bir görevi yerine getirip getirmediği veya …

3
Benioku.txt ve README.txt
Github'da bir proje yaptım, değişikliklerimi yaptım. Bu beni meraklandırdı: Açık kaynak projelerinde çoğunlukla README.txt görüyorum ve düzenlediğim dosya Benioku.txt idi. Bu bir çeşit standardizasyon mu yoksa olduğu gibi bırakmalı mıyım?

2
Yazılım neden Win32 adını kullanıyor?
Bir yazılım / kütüphane Windows platformunu desteklediğinde, dizin ve değişkenlerini hemen hemen her zaman adlandırırlar win32. Bu C / C ++ projelerinde en yaygın olanıdır. MinGW projesinin bile hedefi üçlü kullanır win32. Bunun bir nedeni var mı? Neden Windows veya Microsoft Windows gibi uygun bir isim kullanmıyorsunuz? Adlandırma seçiminde yasal …

2
XMLHttpRequest neden adlandırma kurallarına uymuyor?
Son zamanlarda JavaScript'teki XMLHttpRequest nesnesiyle çalışıyorum ve bu konuda yardımcı olamadım ancak bu adın kasasının bir anlamı olmadığını anladım. 'Http' olmasa da neden 'XML' tamamen kapakta? İkisi de kısaltmalar! Kuşkusuz, adın aşağıdakilerden biri olması daha mantıklı olacaktır: XmlHttpRequest (PascalCase, JavaScript'teki sınıf adları için en iyi yöntem) xmlHttpRequest ( camelCase , …

2
Kongre neden DB tablo adlarının tekil ama RESTful kaynakları çoğul olması gerektiğini söylüyor?
En azından SQL'de veritabanı tablo adlarının tekil olması gerektiği oldukça yerleşik bir kuraldır. Bu soru ve tartışmayaSELECT * FROM user; bakın . Aynı zamanda, RESTful API kaynak adlarının çoğul olması gerektiği konusunda çok eski bir kongredir. GET /users/123ve BunuPOST /users görün . En basit veritabanı destekli API'de, URL'deki kaynağın adı …

6
C # 'nın Pascal kasası yöntem isimlerinin ardındaki felsefe / akıl yürütme nedir?
Bu soru edildi göç o Yazılım Mühendisliği Stack Exchange'de yanıtlanabilir çünkü yığın taşması gelen. 8 yıl önce göç etmiş . C # öğrenmeye yeni başladım. Java, C ++ ve Objective-C'deki bir arka plandan gelince, C # 'nın Pascal-adlarını oldukça benzersiz ve ilk başta kullanması biraz zor buluyor. Bunun arkasındaki sebep …

3
“Artı” ve “Eksi” uygun yöntem adları mıdır?
Java SE 8 tarihlerini, tanıştırmak için yeni bir mekanizma ile gelir LocalDate, LocalTimeve LocalDateTimezamanın anlarının temsil etmek sınıflar. : Böyle anları işlemek için yöntemler bütünüdür verilir LocalDate.plusDays(...), LocalDate.minusDays(...)böylece ve. Her zaman iyi uygulamanın, amaçlarını tanımlayan fiillerden sonra yöntemleri isimlendirmek olduğunu düşündüm, çünkü yöntemler, aslında yapılacak işlemler, bir eylem gerçekleştirecek bir …


1
Kodunuzdaki çoğul tantum ile başa çıkmak için standartlar nelerdir? [kapalı]
Kapalı . Bu soru görüş temelli . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Bu yayını düzenleyerek gerçekler ve alıntılarla yanıtlanabilmesi için soruyu güncelleyin . 4 yıl önce kapalı . Çoğul ve tekil değerleri aynı olan değişkenleri kullanırken bunları nasıl adlandırırsınız? Dışarıda standartlar var mı? Örneğin: Series[] …

7
Sınıfları “Bilgi” sonekiyle adlandırmanın ardındaki fikir nedir, örneğin: “SomeClass” ve “SomeClassInfo”?
Fiziksel cihazlarla ilgilenen bir projede çalışıyorum ve bu projedeki bazı sınıfların nasıl düzgün bir şekilde adlandırılacağı konusunda kafam karıştı. Gerçek cihazlar (sensörler ve alıcılar) bir şey ve onların yazılımda temsil başka bir şey göz önüne alındığında , ben bazı sınıfları "Bilgi" soneki ad desen ile adlandırmayı düşünüyorum. Örneğin, a Sensor, …

Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.