News for hackers. Stuff that matters.
Re:RIP Low-Code 2014-2025 by spiderfarmer on Tuesday January 27, 2026 @07:54AM (#46779355)
Why would anyone need docs.
Re:RIP Low-Code 2014-2025 by _heimdall on Tuesday January 27, 2026 @07:55AM (#46779370)
REST is self documenting.
Re:RIP Low-Code 2014-2025 by jermaustin1 on Tuesday January 27, 2026 @09:54AM (#46780773)
I didn't downvote, but I'm thinking that you need endpoint discovery, bucket types, etc. Sure you could write a 1 page document describing the buckets at the root level, the relationships of the objects, etc., but why not let swagger do that for you at compile time?
Re:RIP Low-Code 2014-2025 by _heimdall on Wednesday January 28, 2026 @12:52AM (#46791570)
I'm talking about actual REST here though, not RPC. Endpoint discover and typed schemas are core pieces of REST, we don't need Swagger or similar to fill in those gaps.
Re:RIP Low-Code 2014-2025 by electroly on Tuesday January 27, 2026 @10:06AM (#46780948)
Not one of the downvoters, but I'd guess it's because this is only true with HATEOAS which is the part that 99% of teams ignore when implementing "REST" APIs. The downvoters may not have even known that's what you were talking about. When people say REST they almost never mean HATEOAS even though they were explicitly intended to go together. Today "REST" just means "we'll occasionally use a verb other than GET and POST, and sometimes we'll put an argument in the path instead of the query string" and sometimes not even that much. If you're really doing RPC and calling it REST, then you need something to document all the endpoints because the endpoints are no longer self-documenting.
Re:RIP Low-Code 2014-2025 by _heimdall on Tuesday January 27, 2026 @11:07AM (#46781826)
But that is roughly the point here. If we still used REST we wouldn't need swagger, openapi, graphql (for documentation at least, it has other benefits), etc.

We solved the problem of discovery and documentation between machines decades ago. LLMs can and should be using that today instead of us reinventing bandaids yet again.

Re:RIP Low-Code 2014-2025 by raverbashing on Tuesday January 27, 2026 @03:45PM (#46786361)
HATEOAS won't give you the basic nouns on which to work with
Re:RIP Low-Code 2014-2025 by _heimdall on Tuesday January 27, 2026 @07:17PM (#46789182)
Right, you wouldn't need HTML at all for LLMs though. REST would work really well, self a documenting and discoverable is all we really need.

What we find ourselves doing, apparently, is bolting together multiple disparate tools and/or specs to try to accomplish the same goal.

Re:RIP Low-Code 2014-2025 by spiderfarmer on Thursday January 29, 2026 @03:26AM (#46807290)
Self documenting, but mainly to the architect who put ‘RESTful’ in the slide deck and called the documentation done.