Pausa caffè #46. 5 modi per migliorare la qualità del codice mentre si lavora in un team di sviluppo. Raccomandazioni per i freelance principianti

5 modi per migliorare la qualità del codice in un team di sviluppo

Fonte: ITnext Quando gli sviluppatori si uniscono in un unico team, di solito sorge un problema legato alla qualità del codice. Se uno sviluppatore lavora da solo su un progetto, non dovrebbe costargli molto sforzo per migliorare la qualità del suo codice. In una squadra può essere molto più difficile. Vedremo cosa influenza la qualità del codice e quali modi per migliorare questa qualità in un team.

Cos'è la qualità del codice?

La codifica non riguarda solo applicazioni già pronte. Naturalmente questo è il risultato principale, ma è importante anche la struttura interna del codice. Un cattivo codice porta a cattive applicazioni, che hanno un impatto negativo sugli utenti. Qualità del codice è un termine usato per descrivere quanto sia leggibile, comprensibile, organizzato e gestibile il codice sorgente. La leggibilità e l'ordine influiscono sulla comprensibilità e sulla manutenibilità del codice. La chiarezza del codice è un fattore importante nel lavoro di un team perché sia ​​gli sviluppatori di applicazioni attuali che quelli futuri dovrebbero essere in grado di comprendere facilmente il codice scritto da un altro sviluppatore. Si dice che il codice sia "manutenibile" quando parti di esso possono essere facilmente modificate, rimosse o migliorate. Se la qualità del codice è bassa, la manutenzione del codice potrebbe richiedere più tempo. Ciò porta ad una costante perdita di tempo. Ora che sai cos'è la qualità del codice e i suoi vantaggi, esaminiamo alcuni modi per migliorarla.

Cinque strategie per migliorare la qualità del codice

1. Brevi commenti ai codici

Quando gli sviluppatori aggiungono commenti al loro codice, alcuni esagerano. Questa non è sempre una buona cosa, ma i commenti sono comunque un ottimo inizio per migliorare la qualità del codice. Quando un nuovo sviluppatore si avvicina al codice di qualcun altro che contiene brevi commenti, è più facile per lui capire cosa sta succedendo, cosa è successo o cosa potrebbe accadere in futuro. Ecco un esempio di un commento non riuscito:

// get all user's posts
const getUsersPosts = () => {
...
}

Come puoi vedere, il commento è molto simile al nome della funzione. Anche senza la funzione possiamo già concludere che i messaggi vengono raccolti dalla banca dati. Ecco un commento migliore:

// check DB to confirm if ticket exists
// all the required information for tickets are available
const verifyTicket = id => {
...
}

Solo leggendo verifyTicket è difficile spiegare cosa sta succedendo. Ma se vedi il commento sopra, diventa molto più facile capire cosa sta succedendo all'interno del codice. Pertanto, anche quando l’implementazione letterale del codice è difficile da comprendere, buoni commenti rendono l’implementazione più semplice da spiegare. Se il tuo team non utilizza i commenti o non li utilizza molto, dovresti prendere l'iniziativa nell'implementazione di questa pratica. Ciò può sembrare inappropriato in alcuni luoghi (magari a causa del livello di esperienza dei tuoi colleghi), ma non lavorerai per sempre con lo stesso gruppo di persone, quindi è importante prendere l'abitudine di utilizzare commenti brevi.

2. Utilizzare strumenti di debug efficaci

Strumenti di debug come Postman , Visual Studio Code , RubyMine , Rookout e altri sono nati per semplificare la vita ai team di sviluppo. L'uso di console.log, l'aggiunta di punti di interruzione a DevTools e altri metodi simili sono utili, ma non sufficienti. Rookout è un po' come un editor. Ovviamente non sostituirà il tuo IDE, ma contiene funzionalità che semplificano il debug. Puoi connettere Rookout alla tua applicazione in esecuzione, aggiungere punti di interruzione (senza interrompere l'implementazione del codice), monitorare e gestire la tua applicazione e ottenere analisi su come sta funzionando. Con gli strumenti di debug, la qualità del codice migliora perché l'attenzione dell'ambiente di sviluppo è sul codice dell'applicazione anziché sul codice di debug. Inoltre, il debug online migliora la sicurezza quando un grande team di sviluppatori lavora al codice.

3. Crea una guida di stile

La coerenza del codice contribuisce notevolmente alla leggibilità. Diversi sviluppatori hanno preferenze diverse. Alcune persone preferiscono le virgolette singole alle virgolette doppie. Alcune persone preferiscono fare quattro spazi invece di due spazi. Alcuni usano alcune regole invece di altre. Poiché questi sviluppatori contribuiscono tutti allo stesso codice, spesso troverai un mix di stili e preferenze in diversi file di progetto. Con una guida di stile, ogni sviluppatore, in quanto collaboratore del progetto, è costretto a seguire le specifiche di stile del progetto. Per farlo in modo efficiente, ci sono strumenti come ESLint e Prettier . ESLint può essere integrato in vari IDE. Dopo aver definito le regole di stile per un progetto nel file di configurazione, ESLint segnalerà gli errori nelle righe di codice che non seguono la guida di stile. Come puoi vedere sopra, ESLint indica errori e visualizza messaggi. Utilizzando questo metodo, puoi assicurarti che il codice del tuo team sia conforme agli standard. Prettier può anche essere integrato in vari IDE. A differenza di ESLint, che indica gli errori, Prettier no. Tuttavia, Prettier può essere utilizzato per formattare il file e correggere ogni riga di codice in modo che corrisponda allo stile impostato.

4. Metti alla prova il tuo codice

Il modo più semplice per determinare la qualità del codice è osservarne il funzionamento. E uno dei modi più adatti a questo scopo è utilizzare i test. Trovare errori di codice mentre la tua app è in esecuzione è una brutta esperienza per i tuoi utenti. Pertanto, se il tuo team non ha ancora implementato le pratiche di test del codice, è meglio iniziare ora. Sebbene scrivere i test possa essere difficile e noioso, ti farà risparmiare un sacco di revisioni lungo il percorso. I test sono al centro di tutte le applicazioni robuste. I test possono essere eseguiti localmente prima del commit o del push del codice nel repository (basato su git-hooks ). Possono essere applicati immediatamente dopo la distribuzione dell'applicazione o anche mentre è in esecuzione. I test ti forniscono una rapida valutazione delle prestazioni della tua applicazione, dandoti fiducia nelle sue prestazioni. È disponibile un numero enorme di strumenti di test a seconda della lingua che stai utilizzando e di cosa stai testando esattamente. Puoi iniziare con questa documentazione .

5. Assegna un nome corretto alle variabili

Scegliere il nome giusto può essere molto difficile. Tuttavia, ricorda che una buona denominazione può migliorare la qualità del tuo codice. Se scegliere un nome è troppo difficile, in questi casi puoi fare affidamento sui commenti. Il bello di un buon nome è che facilita lo sviluppo. Dopo la prima occhiata al nome della funzione, puoi già capire cosa fa la funzione e non è necessario cercare la parte del codice in cui è stata dichiarata la funzione. Un buon titolo è molto utile per comprendere il codice. Suggerimento avanzato: crea funzioni che facciano solo una cosa. Questo aiuta a creare nomi brevi che corrispondono effettivamente al valore restituito.

Raccomandazioni per i freelance principianti

Fonte: Live Code Stream La tendenza al lavoro da casa sta guadagnando slancio dopo che la pandemia di coronavirus ha bloccato la maggior parte delle aziende. E sebbene questo non sia un nuovo concetto di lavoro, ultimamente le persone sono sempre più alla ricerca di modi per fare soldi su Internet. Puoi iniziare a lavorare come freelance o anche lavorare per conto tuo. Spero che questo articolo ti aiuti a imboccare la strada giusta.

Concentrati sulle tue abilità

Il primo passo per diventare un libero professionista è elencare tutte le tue competenze e poi selezionare solo quelle in cui sei più abile. Individuare i tuoi punti di forza ti aiuterà a distinguerti dagli altri. A volte possiamo fare più cose contemporaneamente, il che è del tutto normale. Ma non devi essere un tuttofare. È molto più facile battere i tuoi concorrenti se ti concentri solo su una nicchia specifica. All'inizio è molto importante sviluppare una reputazione di esperto in un particolare campo. Questo ti aiuterà ad acquisire clienti abituali: se cercano un lavoro di qualità, preferiranno sempre un esperto a un freelance generalista. Successivamente, puoi espandere gradualmente i tuoi servizi nelle tue capacità per ottenere più lavoro.

Usa le parole chiave per farti trovare

Se hai già scelto una competenza a cui fornire servizi freelance, ora puoi offrire molti tipi di servizi per ciascuna competenza. Per esempio: Ma soprattutto, se un cliente sta cercando un libero professionista e il tuo profilo o servizio non appare nei risultati di ricerca, probabilmente non ti troverà mai. Pertanto, non otterrai alcun lavoro. Quindi, l’idea di base è inserire il tuo profilo o servizio nei risultati di ricerca. È molto importante che le informazioni su di te siano sempre visibili. Ciò aumenterà le possibilità che i clienti ti trovino. Per ottenere il tuo nome su Internet, devi fare un'approfondita ricerca di parole chiave. È del tutto normale se devi passare qualche giorno a fare questo. Una conoscenza di base della SEO ti aiuterà in questa fase. Se non hai familiarità con i concetti di promozione dei motori di ricerca, ti consiglio di esaminarli. Dato che hai appena iniziato, il tuo obiettivo principale è trovare parole chiave per servizi su cui nessuno sta lavorando o che hanno pochissima concorrenza. Ciò ti consentirà di posizionarti facilmente per parole chiave a bassa concorrenza. Con parole chiave ad alta concorrenza questo sarà molto più difficile. Inoltre, non dimenticare di scegliere parole chiave ad alto rendimento. Ciò significa che le persone devono essere disposte a spendere soldi per ordinare i tuoi servizi. Non c'è motivo di perdere tempo con servizi che nessuno cerca.

Scegli due o tre piattaforme freelance

Recentemente ho pubblicato un articolo sui migliori siti web per liberi professionisti . Prova a guardarlo e scegli due o tre piattaforme con cui iniziare. Il vantaggio principale degli scambi freelance è che agiscono come intermediari, il che riduce significativamente la probabilità di frode rispetto all’interazione diretta con i clienti. È ora di creare profili attraenti su queste piattaforme. In sostanza, devi fornire informazioni dettagliate sui tuoi servizi e mostrare anche un portafoglio interessante. Alcune piattaforme non ti consentono di visualizzare il tuo portafoglio. Quindi, in questo caso, mostra semplicemente i tuoi esempi di lavoro precedenti ai clienti quando ti contattano. Il motivo per cui lavori solo su due o tre siti è che puoi gestire facilmente il carico di lavoro. Puoi espandere questo elenco in seguito. Ma è meglio iniziare in piccolo.

Come fissare i prezzi?

Devi tenere d'occhio i tuoi concorrenti. Scopri cosa offrono e a che prezzo. Ciò ti aiuterà a determinare quali datori di lavoro sono generalmente disposti a pagare per i tuoi servizi. All'inizio fissa un prezzo più basso rispetto alla concorrenza. Consenti ai clienti di esaminare il tuo lavoro prima di aumentare la tua offerta.

Ricerca di potenziali clienti sui social network

Dato che hai appena iniziato, sarà abbastanza difficile per te completare il tuo primo progetto. Consiglio di trovare clienti sui social network e di stipulare contratti con loro tramite uno scambio di freelance. Per fare ciò, condividi il tuo profilo o servizio sui social network. Ad esempio, ci sono molti gruppi su Facebook in cui le persone cercano talenti specifici. Allo stesso modo, LinkedIn può anche essere una grande opportunità per entrare in contatto con potenziali clienti. All'inizio devi dare il massimo e fare un'enorme quantità di lavoro. Ma ti ripagherà rapidamente una volta che inizi a guadagnare denaro in modo coerente.

Fornire risultati di qualità

La cosa migliore del freelance è che non c'è limite a quanto puoi guadagnare in un giorno, mese o anno. Se lo tratti come un business, avrai molto spazio per crescere. L'unico requisito è che devi fornire ai tuoi clienti risultati di alta qualità. Ho scoperto che il feedback/recensione/valutazione dei clienti è il fattore più importante per posizionarsi più in alto nei risultati di ricerca sui mercati freelance. Se i clienti rimangono colpiti dal tuo lavoro, ti daranno sicuramente buone valutazioni. A sua volta, ciò aumenterà le tue possibilità di essere assunto da futuri clienti. A volte è necessario chiedere un feedback al cliente dopo che il progetto è stato completato. Ma questo è possibile solo se è soddisfatto del tuo lavoro. Ricorda sempre che i feedback/valutazioni positivi dei clienti sono la chiave del successo di un freelance!

Gestisci il tempo in modo efficace

I liberi professionisti si sentono rapidamente sopraffatti quando iniziano a svolgere un lavoro regolare. È qui che entrano in gioco le tue capacità di gestione del tempo. A differenza di un lavoro quotidiano, il freelance non è un lavoro dalle 9:00 alle 17:00. Ma sei il capo di te stesso, quindi è del tutto possibile se crei un programma e lo rispetti.

Conclusione

Durante la pandemia di COVID-19, lavorare come libero professionista è diventato particolarmente conveniente. Direi che hai fatto la cosa giusta scegliendo la carriera da freelance. Questo può darti una fonte di reddito più elevata rispetto al tuo lavoro attuale.