We evaluated Stainless, Fern [1], and a few others for Docs & SDKs (soon, CLI) and ended up choosing Fern. Definitely glad we did after today's news. Hadn't seen WorkOS's work here though - thanks for sharing.
> Before your agent can do anything useful, it needs to know what tools are available. MCP’s answer is to dump the entire tool catalog into the conversation as JSON Schema. Every tool, every parameter, every option.
Because this simply isn't true anymore for the best clients, like Claude Code.
Similar to how Skills were designed[1] to be searchable without dumping everything into context, MCP tools can (and does in Claude Code) work the same way.
I spent some time playing around with this recently and loved it at first. I also realized ChatGPT is pretty good at generating Mermaid diagrams (didn't try your own AI features).
However after getting into it some I ran into some significant frustrations. After creating a medium-complexity diagram, I was excited to see the Whiteboard feature to drag things around / improve the layout manually. But it really started breaking, it just wouldn't let me organize/drag things where I wanted, and I couldn't get things to not overlap. I also wished more diagram types supported Whiteboard (I noticed some didn't).
Also I some confusion between the capabilities of mermaidchart.com and mermaid.live. Are these competitors? Variations of similar apps. I was confused. Also "Playground" vs "Live Editor" is confusing.
Overall glad this exists and hope it continues to improve.
At Close we have been offering an 80% salary / 4-day week option for engineering roles for a few years now. This originally was mandatory during early 2020 COVID-19 economic uncertainty as a way to cut costs without doing layoffs. Quickly it became optional – most people moved back to 100% but some people decided they enjoyed it and wanted to continue that arrangement.
What's interesting about 4d weeks is that it's 20% less work but 50% more days off, which can be very impactful for folks.
Our 80% option is a flexible thing, as in you can choose to do it for the summer but not the rest of the year. We try to adjust workloads accordingly. I've taken advantage of it myself for a period of time and it gave me more free time to be with family and also work on side projects.
Some people really love taking our 80% option / 4d and others absolutely don't want to.
Companies offering flexibility in work hours can really help retention IMO, and is a natural progression after (a) remote / freedom of location, and (b) freedom of specific work schedule.
I know a few companies offer "4-day week summers" to everybody or even "everyone always does 4-day weeks". But I like the "fairness" of giving people an option, since different people are in different life situations at different times where working more vs. less can be especially helpful.
[1] https://buildwithfern.com/