Domande con tag 'readability'

domande con tag
3
risposte

Come evitare di cadere nella trappola di non commentare il codice? [duplicare]

Ho lavorato a un progetto per circa un mese. Sono estremamente familiare con il codice e lo capisco nella misura in cui ritengo che sia così facile da capire, che la maggior parte dei metodi non ha bisogno di commenti a mio parere. Non posso d...
posta 14.06.2017 - 16:00
5
risposte

È una cattiva pratica usare i condizionali con funzioni che cambiano lo stato del programma?

Il titolo potrebbe essere un po 'vago, quindi lasciatemi spiegare. Supponiamo di avere una funzione che fa qualcosa (cambia stato del programma), ad esempio una funzione che crea un file. Questa funzione restituisce True se il file è stato creat...
posta 26.03.2018 - 15:52
1
risposta

Dovrei evitare di usare lo stile come 'per k, v in dict_sample.items ()'?

Oggi stavo visualizzando il codice del mio collega e ho visto una funzione come questa: def manager_skill_tree_func(*args, **kwargs): """# manage_skill_tree: Initialize the manage skill tree """ skill_tree0 = {} head = [] t...
posta 16.03.2015 - 11:09
4
risposte

Quando il codice dovrebbe favorire l'ottimizzazione rispetto alla leggibilità e alla facilità d'uso?

Sono in procinto di progettare una piccola libreria, in cui uno dei miei obiettivi di progettazione è che l'API dovrebbe essere il più vicino possibile alla lingua del dominio . Mentre lavoravo alla progettazione, ho notato che ci sono alcuni c...
posta 28.08.2012 - 16:34
2
risposte

Uso di lambda per migliorare la leggibilità di una funzione C ++

Sto cercando di migliorare la leggibilità di una lunga funzione C ++. Questa funzione contiene un numero (> una dozzina) di variabili che vengono utilizzate in tutto. La logica principale del codice è una lunga lista di controlli di condizion...
posta 02.07.2017 - 16:50
3
risposte

È ragionevole scrivere codice di debug peggiore per migliorare il codice di produzione?

Il titolo parla praticamente da solo, ma fornirò l'attuale decisione che sto affrontando. Sto migrando il codice Python verso l'uso di generatori. Il codice attuale ha il seguente aspetto: ... l = returns_a_list(args) log.debug('examining {...
posta 20.10.2016 - 09:43
1
risposta

Distinguere il codice ripetitivo con la stessa implementazione

Dato questo codice di esempio import java.util.ArrayList; import blackjack.model.items.Card; public class BlackJackPlayer extends Player { private double bet; private Hand hand01 = new Hand(); private Hand hand02 = new Hand();...
posta 22.10.2012 - 04:02
2
risposte

Indentazione / interruzione di catene jquery per la leggibilità

Sono curioso di sapere come gli altri indentano / rompono lunghe catene jQuery, dato che non posso mai decidere cosa è più leggibile (in particolare quando si usa .end () per "chiudere" un blocco di metodi, ad es. $(this).not(":has(.pointer)")...
posta 14.04.2011 - 18:17
2
risposte

Ordine dei parametri: dimensione, conteggio o viceversa

Spero che questo sia il forum giusto per questo ... Bene, in C, la libreria standard usa solitamente (void* buffer, int size) quando si fa riferimento ad un buffer di dati. Mi chiedo se esiste una motivazione per questo ordine anziché (in...
posta 08.11.2011 - 21:49
1
risposta

Eccezioni che catturano il codice della clutter e rendono difficile la lettura

Quando leggo un codice ben scritto che controlla che tutto l'input sia del formato e del tipo corretti, e rilevi anche tutte le cose che potrebbero andare storte, trovo difficile capire il nocciolo di ciò che il programma è facendo. Sembra che l...
posta 24.02.2014 - 01:52