Engineering
Can Agile and DevOps Coexist?
A closer look at the similarities and differences between Agile and DevOps, and see when and how they can work together (and when they don’t).
Swimm Blog
Dev updates & more
Release Notes
Join us off the High Dive to Take a Look at 0.4.6!
Join us off the high dive to take a look at some amazing things in Swimm 0.4.6! We’ve got something called Smart Text and it’s going to markedly improve the quality of life for documentation maintainers during refactoring & cool down cycles.
Release Notes
Welcome to 0.4.5!
0.4.5 Cannonballs in with a great new left-nav, Git submodule support, better smart paths and more! Come check out the release notes.
Engineering
Rubber Duck Debugging & How to Use it in Documentation
“Rubber Duck Debugging” is a fun way to structure the flood of unordered thoughts we experience as we investigate strange problems. Turns out, it’s also a fantastic way to provide the structure we need to write effective documentation.
Engineering
The Ultimate Checklist for Agile Software Development
In this post, we provide the ultimate checklist for engineering departments who want to accelerate their agility. Your agile software development journey starts here!
Release Notes
Release Notes - Dive Into 0.4.4
Autocomplete From Snippets, Markdown Export & More - Dive Into 0.4.4! This version implements many improvements to the flow of creating your documentation, making sure it stays in sync, and even easier to read, right where you need it!
Onboarding
How Venn Covered all Documentation Bases for Onboarding New Developers
A special interview with Engineering Manager, Barak Drechsler. >> With $40 million raised in 2019, Venn committed to expand its R&D capabilities. Learn how they are investing in codebase knowledge sharing for new team members >>
Engineering
How To Artfully Dive Out Of Documentation Deficit And Into Continuous Documentation
We know that the lack of documentation coverage is debt that we need to pay down, but we tend to rationalize delaying it. Clues to what to prioritize can be found by running call graphs and debug log analysis, while a goal-oriented approach helps make shorter work of the writing process. Swimm is a tool that, out of the box, helps with all of this.
Engineering
Why Continuous Documentation is crucial for scaling teams
Teams work hard to create pipelines that do most of the repetitive work automatically, reducing the cognitive load of software and infrastructure engineers. Continuous integration and automation are key aspects of high-performing DevOps environments. What about continuous documentation?
Onboarding
How Orca Made Remote Onboarding Work for Engineers
A special interview with Yoav Alon, Chief Technology Officer at Orca Security.
Release Notes
Release Notes - Introducing Version 0.4.0
0.4.0 is our fourth major version release which focused on creating the best experience for developers to start documenting code. Main features included an overhaul of the app structure and the Workspace, Separation of Docs and Exercises, Syncing text with code using slash "/" commands and more.
Release Notes
Release Notes 0.3.8 - Text Blocks, Playlist Editor and Snippet Studio upgrade
In this Swimm Heat (weekly sprint) we focused on adding the Playlist editor, with an update to the snippet studio experience.
Engineering
How to Find the Right Code Knowledge Management Tool
Guest blog by Shay Nehmad, VP R&D at a stealth-mode startup and previously tech lead at Guardicore, lists 4 requirements to look out for in a good code knowledge management tool.
Onboarding
Software Development Knowledge Sharing Methods are Broken: Here’s Why
8 knowledge sharing methods for software development teams and the challenges they present. Read about a new knowledge management vision for code proficiency.
Release Notes
Release Notes 0.3.4 - Advanced Permissions, Synced Units view, and more.
The synced units status page is here and we are very pleased to introduce it as it shines light on one of our core features, the Auto-sync. In this version you will be able to easily see and fix all outdated Units. Also, we added a new onboarding module along with pre-populated content to demonstrate what can be created with Swimm. Jump in and check for updates!
Updates
Sync don't Sink: Why We Built Swimm for Dev Teams
After officially announcing our seed round, here are our goals for 2021.
Engineering
Get Started with Technical Documentation Writing Best Practices
Boost developer productivity and shorten new developer onboarding with readable docs & a good user experience.
Engineering
Engineering Metrics to Increase Developer Productivity
Watching out for these productivity metrics will improve quality of code, time to market and customer satisfaction, as well as do good for the team.
Engineering
Why We Switched From GitHub Issues to Jira to ClickUp
Over the past 15 months, we used and tested three product development tools. We came to some very interesting conclusions about collaboration abilities and resource management. Here’s what we found.
Onboarding
The Perils of Remotely Onboarding to a New Codebase
Almost 80% of developers were already working remotely to some extent prior to Covid-19, and providing healthy coding habits rather than backlog tasks will set high team standards and a safety net for new developers.
Engineering
Supabase: Get started with Vue
Supabase launches its Beta today. Use Swimm to learn more about how to use Supabase with VUE.
Engineering
Infection Monkey Tutorial: Start contributing using Swimm
Infection Monkey, powered by Guardicore, was featured extensively in Swimm’s Open Source Contributor Summit. Shay Nehmad, and Shreya Malviya, a contributor to Infection Monkey, spoke to the participants about how Swimm is making it easier to contribute to the project and make a difference.
Onboarding
Recent Study: 7 Onboarding Best Practices You Should Apply Now
Researchers show how to improve the developer employee onboarding process. See how
Onboarding
7 Open Source Solutions To Optimize Your DevOps Pipeline
These are the Open Source projects we recommend watching and contributing to this Hacktoberfest, to optimize your DevOps pipeline.
Onboarding
4 Ways to Improve Developer Onboarding to Your Open Source Project
OS Maintainers? this read is for you.
Onboarding
The Method we Used to Define our Core Values
Why was it important we choose our company values at such an early stage and how? The discovery process we implemented was unique, quick and extremely rewarding, and is shared in detail in this post.
Engineering
Should CTOs Outsource Commercial Website Development?
Here at Swimm, we developed the website inhouse and served a completely static site with the perks of developing with Vue. So we chose NuxtJS and added a content management layer using Netlify CMS. However, there are several consideration to keep in mind when deciding who will develop the commercial website, here is how to choose.
Engineering
Onboarding Open Source: 5 Things You Can Do Today
If you're looking to getting into open source, here are the basic actions you can take to develop your open source skills and ensure you’re making the most out of what this field has to offer to you.
Engineering
Vue vs React: Best Choice for Startups
“I just have one question for you: Why Vue? I hope you're not rolling your eyes thinking - “ah no, another question about Vue”.
Engineering
A Hands-On Intro to Git Internals: Creating a Repo From Scratch
Diving deep under the hood of Git Internals, we will create (drum roll… 🥁) a repo from scratch and see the wonders of the plumbing beneath porcelain.
Engineering
Why we Chose Node.js over Python for our Product
Goodbye Python my Old Friend: How several demos with our first clients, revealed some major gaps we did not anticipate when starting off with Python.
Onboarding
The Ultimate Guide for Hackathon Success
Community perks: If you’re participating in a hackathon or organizing one, read this guide! We organized a successful hackathon a few months ago and turned our insights into a post
Onboarding
What Every Manager Must Know About Developer Happiness
"You can’t expect developers to fight your most important battles and not to truly and meaningfully invest in them."
Engineering
Top-Down vs Bottom-Up: How to Deep Dive Into a Codebase
Choosing the right approach, and why it’s actually a big deal
Onboarding
Weekly Deep Dev: Trending Pains and why You Should Care
Gleaned from the twitter mines this week, trending pains on mentoring and onboarding brought to you with a dash of humor.
Onboarding
What can "Whiplash" Teach Us About Engineer Mentorship
Op-Ed by Tom Ahi Dror, Co-Founder & CBO at Swimm
Onboarding
Creating Effective and Sustainable Tutorials for your Dev Team
If your onboarding tutorials do not meet the following criteria - you probably shouldn’t bother creating them in the first place.
Onboarding
Why We Started Swimm: Rethinking Engineer Onboarding
An Op-ed article by Swimm's CEO.
Onboarding
Professionalism by Forming a Team Habit
While branded photogenic team building activities are common in many tech companies — especially with rapidly growing teams, this strategy fails to help grow together as professionals and misses the aim in the long run.
Onboarding
Why Most Mentors are Doomed to Fail
While we mostly hear about the “Sink or Swim” approach in regards to new engineers, the truth is, experienced mentors (or 'buddies') are also commonly treated this way - and this in-fact, is the core problem of engineer onboarding.
Onboarding
The End to Pseudo Onboarding: Your Engineers Will Thank You
Getting Engineer onboarding right will get your new hires to solve issues and merge pull requests from day one.
Onboarding
On the Verge of a New Codebase: 5 Smart Moves to Make When Starting a New Job
"I would like to shift the focus to new developers, to you - new hires - and share in this post some tips on how to win onboarding."
Onboarding
Get Started with Swimm: Frequently Asked Questions
Swimm Q&A to help you get started.