3 ms·
This is hands down some of the most constructive feedback we’ve received. You hit the nail on the head. We definitely fell into the author’s trap of structurin
by v0id_isgood 2mo ago
This is hands down some of the most constructive feedback we’ve received. You hit the nail on the head.
We definitely fell into the author’s trap of structuring docs "bottom-up" (Prerequisites -> Basic Syntax -> Advanced Concepts) rather than leading with our actual core innovation: choreography.
We are restructuring the main README/docs front page right now to lead immediately with a concrete example of choreographic execution (e.g., atomic multi-node orchestration / client-server emitting) before getting into standard syntax.
Really appreciate you taking the time to dig into the docs/ dir to pull this out it’s a huge help for our presentation.
- chime 2mo agoYou should still keep doing the bottom-up approach for the rest of the docs. Just update the README first paragraph or two as the gp says.
- jerf 2mo agoYes, strong agree, normalcy resumes at some point. But you want the hook in first. I mean, I'm phrasing that in marketing terms, but in this case it's in harmony with what your users want anyhow. We want to know ASAP why we should care about this language. So it works for everyone. Of course when it comes time to deliver the promise, normal programming language documentation is the way it is for a reason.
- bramadityaw 2mo agoyou should really put some of the content in RESEARCH.md to the README.md. The language's core idea shouldn't just be known to contributors.
- adastra22 2mo agoYou should avoid LLMs in your communications.
- byson94 2mo agoYou do realize its not the real creator right? Its someone impersonating.
- Jabbles 2mo agoI think it's quite rude to reply to a well thought out comment with AI slop
- irq-1 2mo ago> linear/affine types and a perceus reference counting You should put these up front also.
- valorzard 2mo agothis REALLY reads like claude responded to this comment, so I really hope that I'm just mistaken and you just naturally talk like this
- arcrevenant 2mo agoLmfao. This is not an LLM talking but a kid who is learning to write with them, if you look closely. Still concerning