10 extra per un’ottima documentazione di API

In questo follow-up del suo primo articolo sui fondamenti di una buona API, Diana Lakatos esplora attentamente degli utili extra che porteranno la documentazione della vostra API a un nuovo livello. I suoi consigli vi aiuteranno a rendere più usabile e leggibile la vostra API, permeandola con personalità ed esplorando oltre le basi.

Scrivere codice chiaro

Ciò che separa i grandi sviluppatori da quelli bravi è il fatto di scrivere sempre codice il più chiaro possibile. Elimina la confusione, riduce i mal di testa per gli attuali e i futuri developer e fa risparmiare tempo a tutti sul lungo periodo. E sebbene non sia sempre facile come sembra, con una buona programmazione in ottica futura, con un approccio logico alla struttura del codice e con l’adesione ad alcuni principi guida, programmare con maggiore chiarezza è qualcosa alla portata di tutti gli sviluppatori.

The New CSS Layout, un estratto

In questo estratto dal Capitolo 3 di The New CSS Layout di Rachel Andrew, ci viene mostrato come creare una griglia base a tre colonne usando CSS Grid Layout. Poi, ci spiega come disporre degli elementi su più colonne e righe e come usare le aree coi nomi per descrivere il layout direttamente nel CSS.

Di cosa parlo quando parlo di ordinamento: districare Array#sort

Array#sort di Javascript può diventare un potente strumento nella vostra cassetta degli attrezzi, ma senza una pianificazione appropriata e una conoscenza più approfondita dei suoi punti di forza e di debolezza può anche ingannarvi. Claudia Hernández esplora il funzionamento del sorting in vari engine, in che modo creare funzioni di sorting personalizzare e ci aiuta a migliorare le nostre abilità di ordinamento.

I dieci fondamenti di un’ottima documentazione di API

Creare un’elegante API non è il fine ultimo: vi servono sviluppatori che la usino. La vostra documentazione deve metterli nelle condizioni di capire rapidamente cos’è la vostra API, cosa fa e come usarla oppure rischiate di perdere la loro attenzione. In questo pezzo, Diana Lakatos ci offre moltissimi suggerimenti eccellenti su come documentare una API in maniera appropriata.

Sì, quel progetto web dovrebbe essere una PWA

Una Progressive Web App (PWA) è un sito web con poteri speciali. Malgrado quello che potreste aver sentito, la maggior parte dei siti web e, soprattutto i loro lettori, possono trarre benefici dal loro diventare una PWA. Ed è così semplice! Il nuovo editor in chief di A List Apart, Aaron Gustafson, ci spiega tutto.

Fatto compiuto: l’agentive tech è qui

L’intelligenza artificiale è un argomento estremamente hot. Il processo per cui i device di tutti i giorni diventano più coscienti dei nostri bisogni e “imparano” ad adattarvisi giocherà un ruolo importante nel futuro della user experience. In questo estratto da “Designing Agentive Technology, AI That Works for People”, Chris Noessel esamina l’agentive technology e in che modo funziona al posto dell’utente.

Considerare come si usa HTTP/2

HTTP/2 è una dura esperienza sui browser incompatibili. Jeremy Wagner spiega la vera entità dei problemi di performance del mondo reale e come adattare l’invio degli asset del sito alla connessione di ciascun utente.