Pertanyaan yang diberi tag «readability»

Asumsikan sebuah antarmuka yang mengandung metode ini: Car find(long id); List<Car> find(String model); Apakah lebih baik mengubah nama mereka seperti ini? Car findById(long id); List findByModel(String model); Memang, setiap pengembang yang menggunakan API ini tidak perlu melihat antarmuka untuk mengetahui kemungkinan argumen dari find()metode awal . Jadi pertanyaan saya lebih …

14 design  naming  readability  method-overloading 

Baru-baru ini saya menyarankan metode chaining diimplementasikan untuk kelas tertentu dalam proyek tertentu sehingga keterbacaan kode dapat ditingkatkan. Saya mendapat "antarmuka yang lancar tidak seharusnya diimplementasikan hanya untuk kenyamanan, tetapi untuk semantik" menjawab dan saran saya ditembak jatuh. Saya menjawab bahwa saya tidak menyarankan antarmuka yang lancar tetapi metode chaining …

14 architecture  coding-standards  readability  method-chaining 

Saya memiliki banyak kelas yang berhubungan dengan validasi nilai. Sebagai contoh, suatu RangeValidatorkelas memeriksa apakah suatu nilai berada dalam kisaran yang ditentukan. Setiap kelas validator berisi dua metode is_valid(value):, yang mengembalikan Trueatau Falsebergantung pada nilai, dan ensure_valid(value)yang memeriksa nilai yang ditentukan dan tidak melakukan apa pun jika nilainya valid, atau …

13 unit-testing  exceptions  readability 

Ketika Anda harus mengulang pembaca di mana jumlah item untuk dibaca tidak diketahui, dan satu-satunya cara untuk melakukannya adalah terus membaca sampai Anda mencapai akhir. Ini adalah tempat yang sering Anda butuhkan perulangan tanpa akhir. Selalu ada trueyang menunjukkan harus ada breakatau returnpernyataan di suatu tempat di dalam blok. int …

13 c#  code-quality  readability 

Di sebagian besar bahasa pemrograman, variabel tidak memiliki karakter pengidentifikasi seperti yang mereka lakukan di PHP. Di PHP Anda harus awalan variabel dengan $karakter. Contoh; var $foo = "something"; echo $foo; Saya sedang mengembangkan bahasa scripting baru untuk aplikasi bisnis, dan target pengguna saya tidak memiliki latar belakang pemrograman. Apakah …

13 programming-languages  readability 

Saya baru di Clojure. Saya dapat memahami kode yang saya tulis tetapi menjadi terlalu sulit untuk memahaminya nanti. Menjadi sulit untuk mencocokkan tanda kurung. Apa konvensi umum yang harus diikuti mengenai konvensi penamaan dan indentasi dalam berbagai situasi? Sebagai contoh saya menulis contoh de-struktur contoh untuk memahami tetapi kelihatannya benar-benar …

13 readability  clojure 

Saya hanya menulis pernyataan if dengan nama properti yang cukup panjang dan menemukan masalah ini. Katakanlah kita memiliki pernyataan if seperti ini: if(_someViewModelNameThatIsLong.AnotherPropertyINeedToCheck == someValue && !_someViewModelNameThatIsLong.ThisIsABooleanPropertyThatIsImportant) { //Do something } Properti kedua adalah tipe boolean dan tidak masuk akal untuk memiliki stetement seperti if(boleanValue == true) Apakah ada cara …

13 readability 

Ditutup . Pertanyaan ini perlu lebih fokus . Saat ini tidak menerima jawaban. Ingin meningkatkan pertanyaan ini? Perbarui pertanyaan sehingga berfokus pada satu masalah hanya dengan mengedit posting ini . Ditutup 2 tahun yang lalu . Saya ingin tahu tentang ini karena saya ingat sebelum belajar bahasa fungsional, saya pikir …

13 object-oriented  functional-programming  readability 

Pemahaman saya adalah bahwa [Flag]enum biasanya digunakan untuk hal-hal yang dapat digabungkan, di mana nilai-nilai individual tidak saling eksklusif . Sebagai contoh: [Flags] public enum SomeAttributes { Foo = 1 << 0, Bar = 1 << 1, Baz = 1 << 2, } Di mana SomeAttributesnilai apa pun bisa merupakan …

12 c#  .net  readability  enum 

Saya mencoba mengikuti Prinsip Tanggung Jawab Tunggal (SRP) dan juga menghilangkan Pengulangan Kode. Namun sering ada tempat di mana ada pengulangan kode yang tidak lebih dari blok kode doa yang tahan untuk mengekstraksi mereka ke dalam setidaknya metode yang bermakna: DoAction1(); DoAction2(); if (value) DoAction3(); DoAction4(); Apa cara terbaik untuk …

11 refactoring  readability  single-responsibility  code-reuse 

Saya baru-baru ini melakukan refactoring proyek berukuran sedang di Jawa untuk kembali dan menambahkan tes unit. Ketika saya menyadari betapa sakitnya mengejek para lajang dan statika, saya akhirnya "mendapatkan" apa yang telah saya baca tentang mereka selama ini. (Saya salah satu dari orang-orang yang perlu belajar dari pengalaman. Oh well.) …

11 coding-standards  readability  coding-style  static-methods 

Mana yang akan dianggap lebih dapat dipertahankan? if (a == b) c = true; else c = false; atau c = (a == b); Saya sudah mencoba mencari di Kode Lengkap, tetapi tidak dapat menemukan jawaban. Saya pikir yang pertama lebih mudah dibaca (Anda benar-benar dapat membacanya keras-keras), yang saya …

11 .net  code-quality  readability  maintainability  clean-code 

Saya mengerjakan proyek dalam delphi dan saya membuat installer untuk aplikasi, ada Tiga bagian utama. Instalasi / penghapusan instalasi PostgreSQL myapplication (setup myapplication dibuat menggunakan instalasi / uninstall nsi). Membuat tabel di Postgres melalui skrip (file batch). Setiap hal berjalan dengan baik dan lancar, tetapi jika sesuatu gagal saya telah …

11 code-quality  readability  logging 

Saya kira pertanyaan ini akan segera ditandai sebagai subyektif, tetapi menurut Anda mana yang lebih baik: double volume(double pressure, double n_moles, double temperature) { return n_moles * BOLTZMANN_CONSTANT * temperature / pressure; } atau double volume(double P, double n, double T) { return n*R*T/P; } Dengan kata lain, haruskah fungsi …

11 math  coding-style  readability 

Manakah dari ini yang lebih baik untuk pemeliharaan? if (byteArrayVariable != null) if (byteArrayVariable .Length != 0) //Do something with byteArrayVariable ATAU if ((byteArrayVariable != null) && (byteArrayVariable.Length != 0)) //Do something with byteArrayVariable Saya lebih suka membaca dan menulis yang kedua, tetapi saya ingat membaca dalam kode lengkap bahwa …

11 programming-practices  coding-standards  maintenance  readability