Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy) profile picture

CTO at @Redocly

Joined October 2013
πŸ”₯ Just released redoc-cli package! One of the commands is *bundle* which renders an @OpenApiSpec spec into zero-dependency HTML page powered by ReDoc Give it a try πŸ‘€ ! github.com/Rebilly/ReDoc/tre…
1
16
1
37
Very useful feature. Highlights major gaps in the content and makes the docs better for both human and agents.
Which questions does your AI assistant still miss? Project analytics can now show only the conversations where no answer was found, and filter them by the reader's team. The answer filter also updates the stats, the chart, and the CSV export.
2
105
And as a result, we got shocked by our October Blacksmith + GitHub Actions billβ€”it grew 2x in a single month πŸ™ˆ We cut it back down in 1 day of optimizing things. Realized we were overpaying for 2x Actions the whole time, just because the previous bills **looked sane**. Wow.
1
3
230
What we changed: - fewer e2e shards, more workers each, consolidated some repetitive tests - removed some redundant tests - 4 vCPU instead of 8 where CPU was idle - path filters on small workflows - job timeouts - one Renovate PR kept CI hung for 2–6 h, 77 times πŸ™ˆ
21
I don't even know how I lived without clipboard history before.
Replying to @lkr
Clipboard history, opening every app, random ad hoc calculations, currency conversion, I use it like 5000 times per day!
66
It took a while to get approved but here we are!
Redocly is now in @ChatGPT πŸš€ Ask it to lint your OpenAPI description and explain each problem, write a lint rule, or set up a docs site. It searches the live Redocly docs, so it looks things up instead of guessing.
7
197
Same. I often consult with Gemini and use it as reviewer focused on any simplifications
our team uses gemini quite a bit now whenever we have a tricky architectural problem, complex system design questions, or need to simplify something we ask for a gemini subagent it's pretty good here. i don't see this talked about much
2
105
Roman Hotsiy πŸ‡ΊπŸ‡¦ retweeted
How much of your API is actually covered by your OpenAPI definition? With drift --coverage in Redocly CLI, you can measure API coverage and identify gaps between your API and its specification. A simple way to get better visibility into your API coverage and keep your documentation aligned with your API.
1
2
7
193
GitHub stacked PRs are so bad for me. Just adds more problems vs just stacking manually. Especially since agents now remove the manual juggling. The only part I like is the list of the PRs in the stack. I wish they just stopped there - no extra functionality on top.
3
234
Roman Hotsiy πŸ‡ΊπŸ‡¦ retweeted
A search that finds nothing, a question asked for the fourth time: readers keep telling you what your docs are missing. Writer Agent reads those signals, finds the gap, fact-checks a fix against your code, and opens a pull request. You review and merge.
2
2
7
236
I built this a while ago as a Claude Code plugin. I've been using it every day and find It very useful! I also have "comments" section which helps a lot, and "gen" which is generated content like lock files/snapshots.
yoink'd straight into T3 Code :)
3
3
215
Roman Hotsiy πŸ‡ΊπŸ‡¦ retweeted
My year-long creation finally came to life in Redocly CLI this month. I ask my agents to "recheck" their markdown before responding or committing using my presets and rules.
Most docs teams have a style guide. Few have anything that checks it. redocly recheck lints your Markdown pages and the descriptions in your API files: repeated words, sentence-case headings, long sentences, words to avoid. --fix repairs what it can.
1
3
150
Also supports linting prose inside OpenAPI descriptions!
Most docs teams have a style guide. Few have anything that checks it. redocly recheck lints your Markdown pages and the descriptions in your API files: repeated words, sentence-case headings, long sentences, words to avoid. --fix repairs what it can.
1
51
I am quite often adding "it's fine if this is a multi-month project" to my prompts. I'm not sure if it works but otherwise I feel it may discard the best architectural ideas for being "too big."
Funny how frontier models still estimate a task to take 2 weeks when it literally proceeds to do it in 2 hours
4
202
Another big drop from the team! I can't even pick my favorite one this time ☺️
Realm 0.138.0 is out πŸš€ β€’ AI prompts readers open in one click β€’ Navigation tabs β€’ Cookie consent, built in β€’ WebMCP, experimental Same release for Reef, Revel, and Redoc. Highlights 🧡
1
1
104
wooow! So good timing! I've been working on an internal website hosting engine on top of lambda and was about to slowly roll it into prod. Gonna switch it to Web Functions and test ASAP. Looks like it will improve the cold starts situation but also make things more reactive 🀞
AWS just shipped Vercel's Fluid Compute, natively inside Lambda. It's called Lambda Web Functions. Vercel's core compute advantage is now an AWS primitive. What's the same, what's different, and the tradeoffs 🧡
1
5
156
It took us too long to get here but here we are! Finally, the new Redoc Community Edition is out! Modern UI, LLM-friendly and great performance! Go check it out!
Redoc 3 is out πŸš€ Point it at an API description, get docs. That hasn't changed in 10+ years. Almost everything else has: a new design, dark mode, a page for every operation, and OpenAPI, AsyncAPI, and GraphQL in one renderer. Free and MIT licensed 🧡
2
8
278