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

CTO at @Redocly

Joined October 2013
Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)Photo by Roman Hotsiy πŸ‡ΊπŸ‡¦ (@RomanHotsiy)
πŸ”₯ 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
36
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!
52
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
193
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
182
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
234
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
209
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
144
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
103
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
277
Approved in 1 second ☺️ We finally fully completed migration to @voidzerodev Oxlint. Most of rules were moved a while ago but we still had a few in ESLint which were very slow: > Lint time: 8.9 s on main. > The removed ESLint run took 42.5 s.
1
10
547
Very important data to have!
What are people actually asking your docs' AI assistant? Reunite Analytics lists every conversation. Open one to read each question and answer, with sources. Conversations your docs couldn't answer get a "No answer found" tag: your next page to write.
4
166
I've been a Garmin user for a while now. I like the hardware but the soft is not good. Like I could not find a watchface that can show me current tide chart. All of them were ugly af. Finally this problem is solved and I could just vibe-code the perfect one!
4
124