Richard H. Boyd, di mestiere programmatore di software open-source, è salito recentemente agli onori della cronaca per via di questo Tweet:

Hey @awscloud, can we talk about your docs on GitHub? Every time someone complains about how bad the docs are, someone inevitably says "You can create a PR to fix it yourself", but there are dozens of open PRs that are months old with no action from AWS on merging/denying them.

— Richard H. Boyd 🔬🎉 @ re:covery (@rchrdbyd) 14 giugno 2019

La questione è molto semplice: la qualità della documentazione dei servizi AWS è molto scadente. Sembra che Amazon (che fa ampio uso di software open-source all’interno dei servizi che offre) dica ai programmatori: se fa così schifo, sistematevela voi. Solo che, beffa nella beffa, le richieste di integrazione alla documentazione (le citate “PR”) hanno bisogno di essere approvate da Amazon stessa che, per usare un eufemismo, non è esattamente solerte…

Insomma, un’espressione di opinioni diretta, che ha raccolto diversi pareri favorevoli da parte di tanti altri programmatori che si sono trovati nella stessa situazione dell’autore.

L’eco dei commenti s’è fatto talmente ampio che Amazon, nella persona di Jeff Barr, è scesa direttamente in campo:

We’ve addressed that particular PR, and are working on many others. We definitely don’t expect our customers to write the docs, but we value, prioritize, and pay attention to their feedback.

— Jeff Barr ☁️ (@jeffbarr) 20 giugno 2019

E, sì, a quanto pare ha sbloccato la cosa.

Lo stesso Boyd si dice, ai microfoni di businessinsider.com, soddisfatto per il risultato, pur mantenendo un certo scetticismo.

Sì perché alla luce della risposta di Amazon, rimane più di un dubbio:

“we’re working on many others. We definitely don’t expect our customers to write the docs, but we value, prioritize, and pay attention to their feedback.”

“Stiamo lavorando su molti altri PR. Non ci aspettiamo certamente che siano i nostri clienti a scrivere la documentazione, ma teniamo in grande considerazione e priorità il loro feedback.”

Quindi nella sostanza: le documentazione è lacunosa, i clienti che vogliono sistemarla non vengono considerati a meno di tempeste mediatiche, ma non c’è da preoccuparsi, possiamo dormire sonni tranquilli: Amazon sa quando valgono i propri clienti.