Lornajane.net
Lornajane.net
✍️Write rieview ✍️Rezension schreiben 🏷️Get Badge! 🏷️Abzeichen holen! ⚙️Edit entry ⚙️Eintrag bearbeiten 📰News 📰Neuigkeiten
Tags:
… reposted this!
13.3.2025 16:18Comment on Markdown/Mermaid output for OpenAPI Arazzo by lornajaneNice! I used Mermaid recently to manually document type structures in a Go project. Good use of the tech.
12.3.2025 18:17Comment on Markdown/Mermaid output for OpenAPI Arazzo by Mike SchinkelAPI reference documentation changed the way we built integrations, and eventually became part of the driving force for OpenAPI adoption and all the good tooling that flowed from it. As a developer experience specialist, I spend a lot of time … Continue reading
12.3.2025 16:01Markdown/Mermaid output for OpenAPI ArazzoGreat post, Lorna! Your step-by-step guide on creating an OpenAPI spec is super helpful. I especially appreciated the tips on how to structure the documentation effectively. Looking forward to trying this out in my next project!
9.3.2025 09:50Comment on Creating a Simple OpenAPI Spec by dg clubIn reply to <a href="https://lornajane.net/posts/2020/creating-a-simple-openapi-spec#comment-406206">11 WINNER</a>. Great! My brain works better with examples too :)
3.3.2025 09:15Comment on Creating a Simple OpenAPI Spec by lornajaneIn reply to <a href="https://lornajane.net/posts/2025/preview-openapi-as-html-using-scalar#comment-406252">Andreas Gohr</a>. Yes I am, thanks for sharing the link as maybe someone else would find this tool useful.
3.3.2025 09:14Comment on Preview OpenAPI as HTML using Scalar by lornajane[…] From HTTP to OpenAPI with Optic:Lorna Jane shows how to use Optic’s CLI to generate an OpenAPI file for an API lacking one. […]
3.3.2025 08:01Comment on From HTTP to OpenAPI with Optic by Issue #32 – Ikenna Consulting… reposted this!
26.2.2025 22:42Comment on OpenAPI for Web Developers by Reuben Walker… reposted this!
26.2.2025 12:48Comment on OpenAPI for Web Developers by galvao|galvaoetibr@bsky.socialI’ve been using Optic’s CLI, an OpenAPI tool that does a bunch of things including diffing OpenAPI descriptions and comparing HTTP traffic with OpenAPI. My use case was an established API that didn’t have an OpenAPI file yet – using … Continue reading
17.2.2025 10:07From HTTP to OpenAPI with OpticThe API DevTools space is alive and well with lots of new and exciting products popping up all the time. I’ve been especially impressed by the new tools in the docs space, but some of the options are less practical … Continue reading
14.2.2025 14:49Preview OpenAPI as HTML using ScalarMy slide deck tool ( rst2pdf ) produces PDFs, and I use pdfpc to present the PDF slides. It shows the current and next slides, my notes, a timer, and it probably does other things too that I don’t use! … Continue reading
11.2.2025 12:08Presenting with pdfpcIn a recent project around open source contributors, I wanted to take a look at which projects a particular user (actually a few of them, but I wrote a wrapper to repeat the process for each handle) maintains. GitHub doesn’t … Continue reading
27.1.2025 12:48Querying the GitHub GraphQL APIFor teams that generate OpenAPI from their codebase, there’s a tough choice between maintaining rich and extensive content such as Markdown descriptions and examples in codebase annotations, or in making those changes to the generated file – and then losing … Continue reading
9.1.2025 12:18Save edits to OpenAPI as an OverlayI come across a lot of “greedy” GitHub Actions, where automation is running across a whole project instead of only on the parts that are relevant. Examples might be code linters that report problems with documentation folders, or the inverse … Continue reading
7.1.2025 13:39Run GitHub Actions on SubdirectoriesUse an OpenAPI Overlay (or Overlays) to remove deprecated, experimental or private endpoints from your OpenAPI description before publishing to different audiences. Continue reading
12.12.2024 11:37OpenAPI Overlays to avoid API oversharing