Sto cercando un riferimento per gli stili di codifica puliti che posso passare a un membro del team.
In particolare, la regola secondo cui un metodo non dovrebbe cambiare il suo tipo di ritorno in base a un parametro di input. Se hai bisogno di output diversi, usa un metodo diverso.
Esempio:
$invoice_items = getInvoiceItems();
$total = getInvoiceItems( TRUE );
Per me, questo è uno stile di codifica errato (e non sto nemmeno parlando di un parametro il cui significato non può essere determinato dal codice chiamante).
L'esempio sopra dovrebbe essere in realtà:
$total = totalInvoiceItems();
... dove totalInvoiceItems()
potrebbe chiamare getInvoiceItems()
per ottenere gli elementi di cui ha bisogno di totalizzare.
Dove troverei un riferimento a questo (e probabilmente ad altre importanti regole di stile di codifica)?