What's wrong with AI-generated docs https://buff.ly/xAp81oX

let me tell you what’s wrong with docs and docs sets entirely generated by LLMs.

Behold the "yegge memo" of the #genAI era.

"Before asking for more Headcount and resources, teams must demonstrate why they cannot get what they want done using AI." and "Everyone means everyone" -- Tobi Lutke, CEO #Shopify

Unlocking API Discovery with https://Bump.sh Hubs in Your Platform Engineering Strategy · https://Bump.sh https://buff.ly/hhA5ZH8

"API sprawl remains a persistent challenge—APIs are often scattered across different teams, tools, and repositories, making discovery and governance difficult. "

The Information Architecture Philosophy Behind RESTful Web API Patterns and Practices Cookbook https://buff.ly/97cOvn8

Why Aren’t APIs Using Code on Demand?

https://buff.ly/4fYdMgA

"Why aren't APIs taking advantage of code-on-demand, one of the constraints of REST?"

Transforming the Software Development Lifecycle (SDLC) with Generative AI | Amazon Web Services

https://buff.ly/42AnWBd

"Considering code generation, or application development more broadly, generative AI is not only changing the way applications are built, but the way they are envisioned, designed, tested, documented, and deployed."

ChatGPT's odds of getting code questions correct are worse than a coin flip

https://www.theregister.com/2023/08/07/chatgpt_stack_overflow_ai/

"'Our analysis shows that 52 percent of ChatGPT answers are incorrect and 77 percent are verbose,' the team's paper concluded. 'Nonetheless, ChatGPT answers are still preferred 39.34 percent of the time due to their comprehensiveness and well-articulated language style.' Among the set of preferred ChatGPT answers, 77 percent were wrong." -- #ThomasClaburn

The hardest part of building software is not coding, it’s requirements

https://www.cio.com/article/648023/the-hardest-part-of-building-software-is-not-coding-its-requirements.html

"This article will talk about the relationship between requirements and software, as well as what an AI needs to produce good results." -- #JaredToporek

API Maturity
https://medium.com/good-api/api-maturity-fb25560151a3

"Often, when designing an API, I reference to Richardson Maturity Model, and, lately to Amundsen Maturity Model." -- @zdne

#api360 @leonardr

The lawsuit that could rewrite the rules of AI copyright https://b.mamund.com/3tlYI6K

“AI systems are not magical black boxes that are exempt from the law.”

ROFL, stumbled upon a wikipedia page of "failed and overbudget IT projects" and this one cracks me up...

* Cover Oregon
* Healthcare exchange website
* United States State government
* Site was never able to accept online enrollments, so users were instructed to mail in paper enrollments instead.
* approx $200m
* Outsourced
* Cancelled, then client and supplier both sued each other

solid ending!

https://en.wikipedia.org/wiki/List_of_failed_and_overbudget_custom_software_projects

BMW starts selling heated seat subscriptions for $18 a month https://b.mamund.com/3PsWY4D

"BMW has slowly been putting features behind subscriptions since 2020."

#api360 #apiTransactions #microtransactions @TheTedNelson@twitter.com

just published an update to my HyperCLI utility (https://www.npmjs.com/package/@mamund/hyper).

updated the OAUTH plugin to support mastodon.

still some work to do to clear up app vs user authorization but now the fun continues.