Top all-time · #6676
Swimm
Company blog · swimm.io/blogprogrammingcareer
Swimm is the company blog at swimm.io, writing about programming and career. Since 2020, 11 different Hacker News readers have linked it 43 times, most often “Swimm: Knowledge Management and Documentation for Code”. It is still writing: the last post was on 2026-10-07, and you can follow it by feed.
Too few sampled comments (3) to say how often HN recommends it.?
Why HN links it
HN commenters link Swimm's blog for a comparison of code comments and documentation, and mention its docs-as-Markdown-in-repos idea. None of the comments judge the writing itself.
Summarised by Claude from a sample of 3 HN comments that link here. Each comment is marked recommending, critical or neutral (citing without judging); how this works.
We build what you need, grounded in your existing system, and leave your team an agent-ready foundation to keep building on, with Swimm or on their own.
Most-linked posts?
- Swimm: Knowledge Management and Documentation for Code4 people · 4 mentions · first linked 2020-10-08
- We Chose Node.js over Python for Our Product2 people · 2 mentions · first linked 2020-10-31
- Don't Sink, Swim: Guide for Dev Mentors2 people · 2 mentions · first linked 2020-09-14
- Vue vs React: Best Choice for Startups2 people · 2 mentions · first linked 2020-09-23
- We Switched from GitHub Issues to Jira to ClickUp2 people · 2 mentions · first linked 2020-12-17
What Hacker News says?
2 different things https://swimm.io/blog/code-comments-vs-documentation/
Comment linking /blog/code-comments-vs-documentation/
on “Developers spend most of their time figuring the system out”Submitted Vue vs React: Best Choice for Startups as a story · 63 points
HN discussionYou should check https://swimm.io/ 1. Docs are kept as .MD files in your repos 2. You can use Docusaurus to Publish them 3. They use the Github hierarchy and authorization to decide who has access to the docs. They are in beta, worth checking
Comment linking /
on “Ask HN: How do you keep documentation?”Submitted Get Started with Infection Monkey, Open Source Security Tool as a story · 52 points
HN discussionThere are two main problems with wikis : Maintaining and Finding. I'll start with the second, because it is 2023, and wikis are finally embracing semantic search [0] This will not only almost solve this problem. It will also alleviate the need for heavy handed organization in general 9categories..) The first problem is best solved IMO with getting someone responsible for gardening it as someone put it in this thread…
Comment linking /
on “Ask HN: What's the best way to organize a company's engineering wiki?”Submitted Creating Effective Tutorials for Your Dev Team as a story · 25 points
HN discussionSubmitted Creating up-to-date diagrams in internal docs with Mermaid as a story · 17 points
HN discussionSubmitted Software Development Knowledge Sharing Methods Are Broken: Here’s Why as a story · 10 points
HN discussionSubmitted What Every Manager Has to Know About Developer Happiness as a story · 9 points
HN discussionSubmitted Forming Professional Dev Team Habits as a story · 8 points
HN discussionSubmitted Should developer documentation be included in the Definition of Done? as a story · 5 points
HN discussionSubmitted Remote dev teams need better internal documentation as a story · 3 points
HN discussionSubmitted Swimm: Knowledge Management and Documentation for Code as a story · 3 points
HN discussionSubmitted How to Document Tribal Knowledge While Offboarding Employees as a story · 3 points
HN discussionSubmitted We Migrated from Webpack to Vite as a story · 3 points
HN discussionSubmitted We built our GitHub app as a story · 3 points
HN discussionSubmitted Creating a Guide for Code Review as a story · 3 points
HN discussionSubmitted Effective Feedback for Engineers as a story · 3 points
HN discussionSubmitted Rewriting History and Overcoming Git Disasters as a story · 3 points
HN discussionSubmitted We Chose Node.js over Python for Our Product as a story · 3 points
HN discussionSubmitted The End to Pseudo Onboarding: Your Engineers Will Thank You as a story · 3 points
HN discussionSubmitted Evangelizing Mentorship within Asana's R&D Teams as a story · 2 points
HN discussionSubmitted End-to-end testing: challenges, lessons, implementation as a story · 2 points
HN discussionSubmitted Remote onboarding doesn't have to suck as a story · 2 points
HN discussionSubmitted Supabase now in beta, get started with Vue as a story · 2 points
HN discussionSubmitted Supabase now in beta, get started with Vue as a story · 2 points
HN discussionSubmitted Learn how to dive into a new codebase (Front end vs. back end) as a story · 2 points
HN discussionSubmitted We Chose Node.js over Python for Our Product as a story · 2 points
HN discussionSubmitted Don't Sink, Swim: Guide for Dev Mentors as a story · 2 points
HN discussionSubmitted Developing Open Source Skills as a story · 2 points
HN discussion