Blog
The Pool
Notes on legacy code, AI and modernization from the Swimm team.
Latest · Legacy code
We May Be Creating Legacy Code Faster Than Ever
The next bottleneck for AI in software development is whether your code is optimized for it.
Oren ToledanoOct 7, 20262 min readRead the post
Modernization
You Can’t Become AI-Native by Adopting AI Tools
The foundation problem most engineering organizations are ignoring.
Oren ToledanoJul 14, 20265 min read
Modernization
AI just found 10,000 bugs in a month. Finding them is the easy part
A month into Project Glasswing, the numbers settle an old argument.
Oren ToledanoJun 4, 20265 min read
Modernization
We’ve stopped asking customers to bet on the right tool
Swimm is becoming a service company: from Software as a Service to Service as Software.
Oren ToledanoMay 6, 20263 min read
Modernization
Swimm 2.0: the understanding platform for AI modernization
Enterprise IT leaders want an AI modernization capability that works like a factory.
Oren ToledanoMar 24, 20265 min read
Gen AI
Tests are the final gate: why comprehensive test coverage is how humans accept AI
Why tests decide how much of AI's work people are willing to accept.
Inbal GileadMar 15, 202610 min readWhat a coding agent gains from a verified map of 5 million lines
Gen AI
What a coding agent gains from a verified map of 5 million lines
We gave a coding agent a verified map of a 5-million-line open-source codebase, then measured cost, speed and answer quality.
Idan PortalMar 4, 20267 min readEvery rule, every time: what it takes to understand a COBOL application
COBOL
Every rule, every time: what it takes to understand a COBOL application
We ran an AI coding agent and Swimm on two public Medicare COBOL programs and compared coverage, accuracy and consistency.
Omer RosenbaumFeb 25, 202613 min read
Modernization
Application modernization trends: 7 trends reshaping enterprise IT in 2026
What we saw working with enterprise teams on modernization throughout 2025.
Swimm TeamJan 20, 202610 min read
Gen AI
To trust an LLM, make lying harder than telling the truth
Our validator needs an LLM to be honest. This is how we did it.
Omer RosenbaumOct 30, 202511 min read
COBOL
Blackbox to blueprint: Extracting business logic from COBOL applications
How to extract business logic from COBOL applications, step by step.
Omer RosenbaumJul 2, 202512 min read
COBOL
Blackbox to blueprint: Illuminating COBOL systems
So, you need to make sense of a massive COBOL codebase.
Omer RosenbaumJun 4, 20259 min readEvery post, by topic
Archive
160 posts, from our developer-platform years to today
Browse the archiveArchive
Every post, by topic.
160 posts, from our developer-platform years to today.
AI-native engineering 4
Context for AI coding 11
To trust an LLM, make lying harder than telling the truthNov 2025
AI coding without context. What’s the point?Jan 2025
Our take on Google’s new Gemini 1.5 modelApr 2024
Will internal documentation be replaced? An AI discussionFeb 2024
Did “AI kill the documentation star”?Feb 2024
Contextualizing AI: DocumentationFeb 2024
Contextualizing AI: Natural languageFeb 2024
Contextualizing AI: Source codeFeb 2024
LLMs and the Pitfalls of “Memorization Traps”Dec 2023
Understanding the Relationship Between LLMs and NegationAug 2023
Unraveling the Patterns and Key Elements of AI ToolsAug 2023
Legacy code and COBOL 9
We May Be Creating Legacy Code Faster Than EverOct 2026
Application modernization trends: 7 trends reshaping enterprise IT in 2026Jan 2026
Legacy code refactoring in 2024: 5 best practices for enterprise successNov 2025
Blackbox to blueprint: Illuminating COBOL systemsAug 2025
Blackbox to blueprint: Extracting business logic from COBOL applicationsAug 2025
COBOL Modernization and Migration: A Guide for 2025Jul 2025
Modernizing Financial Applications and Services in 2025Jul 2025
The hidden landmine in COBOL’s PERFORM statement: a control flow puzzleMay 2025
A roadmap to working with legacy code: Webinar highlightsJan 2025
Knowledge sharing on engineering teams 21
The four main documentation strategies explainedNov 2025
Why your codebase needs documentation (& how to do it)May 2025
Better code understanding increases productivity. Here’s the data.Mar 2025
Empower remote engineering teams with documentationJan 2025
Developer documenting done right: why, who, what, where, when & howJan 2025
Get started with technical documentation writing best practicesJan 2025
Stop chasing your tail: A practical guide to maintaining complex systemsJan 2025
Here’s what the 2024 DORA report has to say about code documentationNov 2024
Documentation drives developer experience. Here’s why.Aug 2024
Swimm Whitepaper: Meeting the challenges of today’s software development teamsAug 2024
How to find the right code knowledge management toolJan 2024
Code comments vs. documentation - context and codeNov 2023
5 code documentation resolutions for 2023Aug 2023
Takeaways from GitHub’s 2021 Octoverse Report: documentation is a game changerAug 2023
Accessible & discoverable knowledge promotes inclusive teamsAug 2023
Documentation strategies for busy peopleJul 2023
Documentation, dev teams, and the Definition of DoneJul 2023
Building a strong knowledge sharing culture on engineering teamsJul 2023
How to document tribal knowledge while offboarding employeesJul 2023
Rubber duck debugging & how to use it in documentationJul 2023
The hidden value of code documentation: a success factor for M&AJul 2023
Onboarding, mentoring and open source 15
4 ways to improve developer onboarding to your open source projectJan 2025
Onboarding open source: 5 things you can do todayJan 2025
The end to pseudo onboarding: your engineers will thank youJan 2025
Recent study: 7 onboarding best practices you should apply nowJan 2025
The perils of remotely onboarding to a new codebaseJan 2025
Onboarding documentation for growing dev teams: an investment in successJan 2025
Infection Monkey tutorial: start contributing using SwimmAug 2024
How I onboarded remotely with Swimm… to SwimmMay 2024
Weekly deep dev: trending pains and why you should careMay 2024
On the verge of a new codebase: 5 smart moves to make when starting a new jobNov 2023
Why we started Swimm: rethinking engineer onboardingSep 2023
Why most mentors are doomed to failAug 2023
What can “whiplash” teach us about engineer mentorshipAug 2023
Top-down vs bottom-up: how to deep dive into a codebaseAug 2023
Creating effective and sustainable tutorials for your dev teamJul 2023
Engineering leadership and process 17
Creating a code review guideMar 2025
The “R” in R&DJan 2025
A CTO’s work protocols: Balancing structure and creativityDec 2024
Engineering Your Feedback - Providing Effective Developer FeedbackJan 2024
SOC 2 compliance - a guide for developersJan 2024
Time management tips for developers and engineersJan 2024
Effective developer feedback: a guide for R&D managersNov 2023
Scaling the engineering organization: building successAug 2023
What every manager must know about developer happinessAug 2023
The ultimate guide for hackathon successAug 2023
Should CTOs outsource commercial website development?Aug 2023
Engineering metrics to increase developer productivityAug 2023
Optimizing product growth with product analyticsAug 2023
Feeding the beast - writing tasty dev tasksAug 2023
The ultimate checklist for agile software developmentAug 2023
Professionalism by forming a team habitJul 2023
Improving developer productivity on R&D teamsJul 2023
Developer tutorials and tools 18
Rewriting history and overcoming Git disasters (Gitsasters) part 1: Git resetMar 2025
Surviving the transition to microservicesMar 2025
The ultimate tech podcasts from the Swimm R&D teamAug 2024
VS Code vs. WebStorm - a detailed comparisonJun 2024
How Swimm selected a payment providerMay 2024
End-to-end testing: challenges and lessons learnedJan 2024
Overcoming Git disasters (Gitsasters) Part 2: Git cherry-pick, Git revert, and Git reflogNov 2023
Top 17 software developer conferences for 2023Aug 2023
Webpack to Vite: our migration storyAug 2023
The top 10 reasons dev teams can be thankful this ThanksgivingAug 2023
Why we chose Node.js over Python for our productAug 2023
A hands-on intro to Git internals: creating a repo from scratchAug 2023
Vue vs React: best choice for startupsAug 2023
7 open source solutions to optimize your DevOps pipelineAug 2023
Supabase: get started with VueAug 2023
Why we switched from GitHub issues to Jira to ClickUpAug 2023
Microservices architecture guide: four things to consider prior to migrationAug 2023
Swimm’s top DevTools - our 2023 picksAug 2023
Platform launches and benchmarks 3
AI documentation features 8
Meet /ask Swimm: Your teams’ contextual AI coding assistantNov 2025
How Swimm uses static analysis to generate quality code documentationNov 2025
How we automatically generate documentation for legacy codeSep 2025
Announcing Swimm AI Beta: The best way to document codeSep 2024
Designing AI-Powered Content Suggestions for Tech DocumentationAug 2024
Making a Splash: Swimm’s New Generative AI Software Documentation CapabilitiesFeb 2024
Bringing it all together: Introducing /ask SwimmFeb 2024
Swimm AI Beta: 4 use cases that redefine code documentationOct 2023
Feature guides 18
Docs as Code: understanding Swimm’s sw.md Markdown formatJan 2025
How does Swimm’s Auto-sync feature work?Jan 2025
Walk developers through your codebase with Documentation PlaylistsJan 2025
Swimm universal playlists - as code coupling for continuous documentationJan 2025
Get started with Swimm: frequently asked questionsJan 2025
The rubber duck debugger: debugging using Swimm documentationAug 2024
The wet floor sign: incident management and Swimm’s platformMay 2024
How Swimm uses SwimmMay 2024
IDE integrated documentation using SwimmMay 2024
Sync don’t sink: why we built Swimm for dev teamsJan 2024
Walkthrough Documentation: a guided tour of your codebaseDec 2023
What is Continuous Documentation? The manifestoNov 2023
Swimm notifications keep you updated on docsAug 2023
Integrating Swimm and Continuous Documentation into your workflowAug 2023
Why Continuous Documentation is crucial for scaling teamsJul 2023
How to artfully dive out of documentation deficit and into Continuous DocumentationJul 2023
Advanced documentation editor: how to create code-coupled docs in secondsJul 2023
How to use Swimm code documentation templatesJul 2023
Integrations 15
Using Swimm’s GitHub App to manage your engineering team workflowsJan 2025
Create up-to-date diagrams with Swimm’s Mermaid integrationJan 2025
Announcing the Swimm and Backstage integrationJan 2025
Announcing the Swimm for GitHub Copilot extensionNov 2024
Docs as part of your CI: Swimm for GitLabFeb 2024
Announcing our latest integration with BitbucketFeb 2024
New CI integration: Swimm for Azure DevOps ServicesFeb 2024
Announcing Swimm’s IDE plugin: The most intuitive way to document codeJan 2024
Swimm and gitStream (powered by LinearB): Automate doc-related PRsAug 2023
Keeping internal docs up to date, always, with the Swimm GitHub AppAug 2023
Swimm + IntelliJ - announcing the dynamic documentation duoAug 2023
Swimm’s IDE plugins brings knowledge to your engineers in timeAug 2023
Swimm is an official Compass Integration partnerAug 2023
Swimm native integrations help keep your docs up to dateAug 2023
Continuous Documentation through continuous integration with SwimmJul 2023
Release notes 10
Swimm 0.3.4 - advanced permissions, synced units view, and moreAug 2024
Welcome to Swimm 0.4.5!Aug 2024
Release notes - introducing Swimm version 0.4.0Aug 2024
Swimm release notes - dive into 0.4.4Aug 2024
Swimm release notes 0.3.8 - text blocks, Playlist editor and snippet studio upgradeAug 2024
Join us off the high dive to take a look at Swimm 0.4.6!Aug 2024
Check out 0.4.8: performance upgrades, new snippet gallery drawer and Gitlab integrationsJan 2024
Accelerate your documentation creation: Swimm release notes roundupJan 2024
What’s new: Swimm features updateJul 2023
New fluid editor with image tools, Azure DevOps integration - 0.5.0 is a waterfall of major new featuresJul 2023
Company news and culture 11
Swimm 2021: a year in reviewJan 2025
Swimm named a Gartner Cool Vendor: Here’s why AI-augmented development mattersSep 2024
The method we used to define Swimm core valuesAug 2024
The life of an engineering manager at SwimmMay 2024
One tool - all your code knowledge. Meet SwimmAug 2023
Announcing season 2 of Swimm’s podcast - Swimm UpstreamAug 2023
Celebrating Swimm’s $27.6M Series AAug 2023
Introducing Swimm’s new podcast - Swimm UpstreamAug 2023
Happy birthday Swimm - a letter from the CEOJul 2023
Get to know Swimm users: the Hunters dev teamJul 2023
CEO sync | interview with Sagi Rodin - CEO and co-founder of FronteggJul 2023
Have a legacy system of your own?
30 minutes with our team. Bring the system you have in mind.