News for hackers. Stuff that matters.
Re:AsyncAPI – OpenAPI-like specification for event-driven ar... by verdverm on Monday March 30, 2020 @12:40PM (#22729525)
https://cuelang.org has something to say about this
Re:AsyncAPI – OpenAPI-like specification for event-driven ar... by HighlandSpring on Monday March 30, 2020 @01:45PM (#22730270)
This looks vaguely relevant so figured I'd ask the question here.

I'm working on what can be pretty well reduced to an AST builder. I have nodes of certain types which come with a set of relevant properties as well as the set of types that you're allowed to nest. I'm looking for a markup language to express these schemas so that I can generate the UI components (given parent node X, generate a widget with a form that can be used to submit legal children) and perform validation (given AST tree coming from the client, validate it server-side before persisting it)

Currently using JSON schema but it's very verbose. Any ideas?

Re:AsyncAPI – OpenAPI-like specification for event-driven ar... by verdverm on Monday March 30, 2020 @03:53PM (#22731644)
cuelang is great for this, I highly recommend spending some time. It's not the easiest to on board yet, jump in slack though and we'll be happy to help.

The project we are building on top of cuelang may be of interest: https://github.com/hofstadter-io/hof

Re:AsyncAPI – OpenAPI-like specification for event-driven ar... by Mazzen on Monday March 30, 2020 @12:52PM (#22729676)
Their slogan is catchy but breaks bad in (my) mobile view
Re:AsyncAPI – OpenAPI-like specification for event-driven ar... by Mazzen on Monday March 30, 2020 @12:56PM (#22729710)
Documentation is also clearly expecting the user to read the page on a desktop device. If you are part of the project, please check it out. Interesting concept!
Re:AsyncAPI – OpenAPI-like specification for event-driven ar... by verdverm on Monday March 30, 2020 @03:57PM (#22731681)
They are using an older version of https://docsy.dev for their docs site.

How does this one look on mobile? https://docs.hofstadter.io

I just started that yesterday from the most recent docsy.