Dev updates & more
Teams can be very guarded when it comes to potential impact to their workflow. We describe a goals-oriented approach to planning your shift to continuous documentation through continuous integration that helps everyone visualize and feel comfortable about the changes through a smooth, gradual transition.
Swimm’s fluid documentation editor helps you keep your inner dev loop running quickly and smoothly while still keeping your documentation in sync and comprehensive. With most things not requiring your hands to leave the keyboard, you can crank out beautiful documentation built right on your code.
Code documentation will always fail if engineers can’t find it when they need it. Swimm’s IDE plugins help engineers find the right amount of information exactly when they need it, and work hand-in-hand with well commented code to make sure knowledge can be discovered.
Documentation quickly becomes stale as code changes. Continuous documentation focuses on ensuring documentation remains up-to-date and usable as the code changes. Check out our very own Omer Rosenbaum about Continuous Documentation!
Bringing to you our user case studies, examples of how developer teams across the globe use Swimm to build up knowledge and ship code as efficiently as possible.
The ways that documentation is created stem from a combination of four main documentation strategies. Breadth-first and Depth-first approaches are the most widely known, but documenting common tasks or simply answering the most common questions is also very effective.
Microservice architecture can help you solve real problems for your users much more rapidly and robustly than monolithic patterns, but there are many things to consider including switching from well-documented code to no documentation as complexities go up exponentially.
It’s September 2019, and 4 co-founders met with a bunch of lawyers, signed a few papers, and a few days later on September 18th, **Swimm was born!**
A list of tech podcasts for every kind of developer listener. These podcasts cover deep tech content, tech culture and management, and developers' day to day life and more.
Whether you don't have time, or just hate writing, we've got some ideas that can help you get your documentation written.
Don't rely on situational circumstances to convey essential knowledge to new hires; make the path deliberate and equally valuable to those that learn on their own, and those that learn best in groups. Present everyone with the same breadth of knowledge so that everyone knows what there is to learn, and let them learn in a way that works best for them.
Coffee Decoded is a series of blog posts interviewing the Swimm Dev team on their top tips for users aiming to also offer an opportunity to get to know the team more personally.
Swimm Documentation Can Now Be Discovered And Consumed Directly From Any IntelliJ IDE!
Swimm 0.5.0 is a major release, featuring a significantly improved fluid editing experience with new image tools, a faster and more fluid snippet selection workflow and support for Azure DevOps Pipelines!
Companies acquire other tech companies for their customer base, code or talent. While sometimes the acquired company keeps operating as an autonomous unit, more often than not a technological integration is required. Read more about how code documentation can become the secret sauce to winning M&As in 2021.
0.4.8 Comes with much improved snippet selection through the Snippet Studio Drawer, Gitlab Integration and Numerous Performance Upgrades. We're relentless when it comes to removing friction in documentation.
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.
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.
“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.
In this post, we provide the ultimate checklist for engineering departments who want to accelerate their agility. Your agile software development journey starts here!
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!
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 >>
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.
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?
A special interview with Yoav Alon, Chief Technology Officer at Orca Security.
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.
In this Swimm Heat (weekly sprint) we focused on adding the Playlist editor, with an update to the snippet studio experience.
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.
8 knowledge sharing methods for software development teams and the challenges they present. Read about a new knowledge management vision for code proficiency.
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!
After officially announcing our seed round, here are our goals for 2021.
Boost developer productivity and shorten new developer onboarding with readable docs & a good user experience.
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.
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.
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.
Supabase launches its Beta today. Use Swimm to learn more about how to use Supabase with VUE.
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.
Researchers show how to improve the developer employee onboarding process. See how
These are the Open Source projects we recommend watching and contributing to this Hacktoberfest, to optimize your DevOps pipeline.
OS Maintainers? this read is for you.
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.
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.
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.
“I just have one question for you: Why Vue? I hope you're not rolling your eyes thinking - “ah no, another question about Vue”.
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.
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.
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
"You can’t expect developers to fight your most important battles and not to truly and meaningfully invest in them."
Choosing the right approach, and why it’s actually a big deal
Gleaned from the twitter mines this week, trending pains on mentoring and onboarding brought to you with a dash of humor.
Op-Ed by Tom Ahi Dror, Co-Founder & CBO at Swimm
If your onboarding tutorials do not meet the following criteria - you probably shouldn’t bother creating them in the first place.
An Op-ed article by Swimm's CEO.
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.
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.
Getting Engineer onboarding right will get your new hires to solve issues and merge pull requests from day one.
"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."
Swimm Q&A to help you get started.