Skip to main content

Benefits of Code-Coupled Documentation

Swimm is private and secure
Swimm is SOC 2 and ISO27001 compliant. Swimm does not modify any of your code and none of your actual code or content is stored on Swimm’s servers, including your GitHub token. All data transferred to and from Swimm’s servers is encrypted during transit..

Swimm users see immediate results: highly productive developer teams, quality documentation, faster onboarding, and collaborative culture where documentation can be trusted (it's up to date!) and knowledge sharing is prioritized.

1. Create your docs and notes easily and quickly with Swimm's code-coupled editor​

We’re all short on time. Write your docs and notes quickly using Swimm’s code-coupled editor, which has rich text capabilities (colors, fonts, images, hyperlinks), Markdown, and live code snippets to embed in your docs from your repositories.

Once you get started with documentation, you'll understand the bigger picture of your documentation coverage and be able to set coverage priorities and goals for your teams.

2. Consume your docs right in your IDE​

IDE-integrated documentation is the easiest and most convenient way to read documentation. Your docs and notes are inside your IDE, so you don’t have to switch contexts to access your docs and search for existing documentation.

Swimm supports IDE integrations with VS Code and IntelliJ plugins.

3. Update your docs automatically​

Swimm’s Auto-sync feature automatically keeps your code snippets up to date when your code changes. If Swimm’s Auto-sync algorithm determines that a change in the code is important enough that more information is needed, Swimm’s verification check fails, affected docs are marked as potentially out of date, and you are updated.

4. Streamline every PR with Swimm’s GitHub App​

Swimm’s GitHub app helps you streamline every pull request to verify that your documentation stays up to date. To get the Swimm GitHub app, first sign up for Swimm, and once you set up your workspace and connect a repo, go here and install it on your repos.

5. Import files to Swimm from Notion and Confluence​

Start importing files directly from your computer to Swimm or importing existing documentation from Notion and Confluence. Once you import your files, you can replace code blocks with code snippets to keep your docs up to date.

6. Onboard your team with doc Playlists​

Playlists are collections of docs, links, videos, Markdown files, and images that are put into a collection. It is one of Swimm’s most popular features, especially for onboarding.

7. Knowledge sharing and collaboration with up-to-date & trusted documentation​

Code-coupled documentation has transformed knowledge sharing and collaboration on dev teams. Once teams streamline documentation so that code and documentation are created and maintained together, knowledge is no longer scattered (and lost and documentation can be trusted.

TL;DR

Swimm Impact

  • Create docs easily and effortlessly with Swimm's code-coupled editor.
  • Consume your docs in the IDE. Swimm has plugins with VS Code and IntelliJ.
  • Streamline everything with Swimm's GitHub app.
  • Import existing docs and files from Notion & Confluence.

Knowledge sharing is essential to building trust, leading to to strong team cultures and increased developer satisfaction.