Pertanyaan yang diberi tag «naming-standards»

17
Standar pengkodean untuk kejelasan: komentar setiap baris kode?
Saya telah bekerja di toko-toko yang menghasilkan perangkat lunak yang sangat penting dan saya telah berurusan dengan aturan komentar yang dimaksudkan agar kode tersebut dapat dibaca dan berpotensi menyelamatkan nyawa. Dalam pengalaman saya meskipun persyaratan menjadi tugas yang mematikan otak untuk dicentang dari daftar periksa dan tidak membantu saya tetap …

2
Konvensi penamaan file python?
Saya telah melihat bagian PEP-8 ini https://www.python.org/dev/peps/pep-0008/#package-and-module-names Saya tidak jelas apakah ini merujuk pada nama file modul / kelas / paket. Jika saya punya satu contoh masing-masing, haruskah nama file semua huruf kecil dengan garis bawah jika sesuai? Atau sesuatu yang lain?

8
Masalah penamaan: Haruskah "Sesuatu" diubah namanya menjadi "Sesuatu"? [Tutup]
Bab Paman Bob tentang nama dalam Kode Bersih merekomendasikan agar Anda menghindari penyandian nama, terutama yang berkaitan dengan notasi Hongaria. Dia juga secara spesifik menyebutkan menghapus Iawalan dari antarmuka, tetapi tidak menunjukkan contoh ini. Mari kita asumsikan sebagai berikut: Penggunaan antarmuka terutama untuk mencapai testabilitas melalui injeksi ketergantungan Dalam banyak …

1
Konvensi Penamaan Protokol Swift [ditutup]
Berasal dari latar belakang c #, saya terbiasa menggunakan istilah "antarmuka" untuk menggambarkan suatu objek tanpa implementasi yang mendefinisikan perilaku. Di c #, konvensi ini untuk menambahkan nama antarmuka dengan "I", seperti pada IEnumerable, dll. Tentu saja, konsep tersebut memiliki nama yang berbeda dalam bahasa yang berbeda. Dalam Swift, konsep …


9
Bagaimana memberi nama metode yang melakukan tugas sekaligus mengembalikan boolean sebagai status?
Jika ada metode bool DoStuff() { try { // doing stuff... return true; } catch (SomeSpecificException ex) { return false; } } haruskah lebih baik disebut IsStuffDone()? Kedua nama bisa disalahtafsirkan oleh pengguna: Jika nama itu DoStuff()mengapa ia mengembalikan boolean? Jika namanya IsStuffDone()tidak jelas apakah metode melakukan tugas atau hanya …

3
Readme.txt vs. README.txt
Saya baru saja bercabang proyek di Github, membuat perubahan saya dll. Ini membuat saya bertanya-tanya: Saya melihat sebagian besar README.txt dalam proyek opensource dan file yang saya edit adalah Readme.txt. Apakah ini semacam standar atau haruskah saya membiarkannya?

2
Mengapa perangkat lunak menggunakan nama Win32?
Jika suatu perangkat lunak / perpustakaan memiliki beberapa dukungan untuk platform Windows mereka hampir selalu menamai direktori dan variabel mereka sebagai win32. Ini paling lazim dalam proyek C / C ++. Bahkan target triple project MinGW menggunakan win32. Apakah ada alasan untuk ini? Mengapa tidak menggunakan nama yang tepat seperti …




3
Apakah "plus" dan "minus" nama metode yang sesuai?
Java SE 8 hadir dengan mekanisme baru untuk kencan, memperkenalkan LocalDate, LocalTimedan LocalDateTimekelas - kelas untuk mewakili contoh waktu. Untuk memanipulasi instants tersebut, satu set metode yang diberikan: LocalDate.plusDays(...), LocalDate.minusDays(...)dan sebagainya. Saya selalu berpikir bahwa praktik yang baik adalah penamaan metode setelah kata kerja yang menggambarkan tujuan mereka, karena metode …



7
Apa ide di balik kelas penamaan dengan akhiran "Info", misalnya: "SomeClass" dan "SomeClassInfo"?
Saya bekerja di sebuah proyek yang berhubungan dengan perangkat fisik, dan saya bingung bagaimana cara menyebutkan beberapa kelas dengan benar dalam proyek ini. Mengingat perangkat yang sebenarnya (sensor dan penerima) adalah satu hal, dan representasi mereka dalam perangkat lunak adalah hal lain, saya berpikir tentang penamaan beberapa kelas dengan pola …

Dengan menggunakan situs kami, Anda mengakui telah membaca dan memahami Kebijakan Cookie dan Kebijakan Privasi kami.
Licensed under cc by-sa 3.0 with attribution required.