We're pleased to announce the availability of Swimm 0.9.7❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Mermaid Diagrams in Swimm - You can now add diagrams and charts to your documentation in Swimm, using mermaid syntax in the editor. Type /mermaid to start editing your mermaid diagram, or use templates from Mermaid Live Editor.

• Admin Rules- Admins in Swimm can now automate workflows using Swimm's GitHub App. Admins can set conditions and actions to promote documentation creation and consumption.

• Continuous Publish - Admins can now allow publishing docs from a repo to the Cloud, so that even when users don't have access to the repo, they will still be able to view those docs. Published docs are kept in sync with Swimm's GitHub App.

• Multi-repo Docs - Multi-repo docs are docs that contain one or more snippets from more than one repository. With Swimm, you can now create docs with code snippets across multiple repositories. Here's how: when opening the Snippet Studio, select snippets from any workspace repository. Note that selecting Smart Tokens and Smart Paths from other repositories is not currently supported. Snippets in a Multi-repo doc from other repositories are always Auto-synced from the default branch. When there are outdated or Auto-synced snippets in a Multi-repo doc, they can be resolved directly from the Swimm App (not from Swimm's GitHub App).

• Global Search - You can now search from anywhere across code-coupled docs, cloud docs, and Playlists in your workspace. To search, use ⌘+K (MacOS) or CTRL+K (Windows/Linux) or the search icon at the top right corner. For code-coupled content, Swimm will perform a global search only on the default branch and on committed docs/Playlists.

Improvements:​

• New Section for Docs and Playlist Versions - Instead of viewing multiple files for each version of a doc, you can now see the most relevant version of the Doc or Playlist. Docs with versions in-progress will have a small stack icon near their name. When you click the icon, you’ll see all versions of your Doc and Playlist (drafts, pending, and committed).
• Multiple File Import - Swimm now supports the ability to import multiple Markdown files. You can choose whether you want to import files from your computer, or Swimm can scan your repo and detect all of your Markdown files to create Swimm docs.

Bug fixes:​

• Fixed: when creating a doc from a PR and discarding the generated draft, the draft is now removed.

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.9.6❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Publish to Cloud Docs - Publish your Repo Docs to the Cloud so that anyone from your workspace can review - even if they don't have access to your repo.
• Changing the Order of Repositories- You can now change the order of repositories displayed on the left-side navigation. To change the order, hover over any repository and drag the repository using the new 8-pin icon. Note, that changing the order only affects your Swimm account and not other members' accounts.
• Recommended Files to Document - Based on Swimm insights about your repository, we now make recommendations for files that you may wish to document. Recommendations can be found under "Insights" and are a great place to get started.
• New Documentation Hub - Located on the left navigation panel, Admins can now add links to other documentation sources - all in one place - with Swimm's new Documentation Hub.

Improvements:​

• Doc from PR - Additions or changes in any package-lock.json or yarn.lock file will not appear in a doc created with the Doc from PR feature.
• Adding Tags to Doc Drafts - It is now possible to add tags to a doc draft before the doc is committed. Tags are saved in the doc when the draft is committed.
• Timeout Added to Swimm Verify Checks - A timeout was added to the Swimm Verify check to let users re-run a check which didn't finish due to an internal issue.
• Slack Notifications - When a user renames an existing doc and commits it, no Slack notifications are sent to the Admin-defined channel in Swimm's Slack app.
• CodeBlock Syntax Highlighting - Now, CodeBlocks will display a colorful theme and a language selector.

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.9.5❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Cloud Docs- You can now create and store docs in the Cloud without connecting to a GitHub repository. Cloud Docs are great not just for developers but for any other roles in your organization (such as Customer Support, Sales Engineering, or Product Management) to store knowledge about processes, methodologies, or other internal technical documents such as PRDs, Sprint Retros, or other docs you wish to keep internally across your organization.

Improvements:​

• Commit Multiple Changes - You can now commit multiple changed documents in a single commit. There is a new section at the top of the home/repo page called "Commit Changes".
• Video Links - Youtube video links are now automatically embedded as a video player in docs.
• Tags - You can now easily manage (add, remove, or rename) tags on any of your docs directly from within the Home Page, Everything Page, or from within a specific repository.
• Assigning Docs - You can now assign a doc to multiple users at the same time, using the existing Assign feature from the doc sidebar area.
• Creating Docs from PRs - When creating a new doc from a Pull Request and manually entering a PR number, the new doc will be created on the PR branch instead of the default branch.
• Doc Requests - A doc request will automatically be marked as completed once you've merged its associated doc to the default branch. Note, that this requires installing the Swimm GitHub App.
• Swimm Verify Check Run - You can rerun an existing Swimm Verify check run via the Swimm GitHub App in cases, for example, when a check run is canceled or if there is an issue with the initial check run.
• Providing Feedback to Swimm - We improved our feedback form which is available in the Help Center.
• Keyboard Shortcuts - Improved the keyboard shortcuts section for Swimm’s Editor - also available in the Help Center.
• Help Articles - The Help Center now has a new section with many helpful articles to help you get started with Swimm.

Bug fixes:​

• Fixed when the Swimm GitHub App is installed, but the initial .swm/swimm.json file is not merged.
• Fixed preview mode UI issues with long titles and placeholders on templates.

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.9.4❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Sharing Doc Drafts- As an admin, you can now let users share doc drafts with teammates. This ability can be configured on a repository level via the Integrations & Settings page. The default setting is the Local Drafts . Once an admin selects the Cloud Drafts option, new drafts created by any user will be stored in the cloud for 30 days unless committed before then. Users can share a doc draft by clicking the share icon from the top right corner of the edit doc page and clicking on the Copy Link .

• Doc & Playlist Creation Hub- Creating new docs has never been easier. Simply click the "New" button on your repo page and see all the options to start creating new documentation.

Improvements:​

• Viewing and Edit Docs - When viewing or editing a doc with snippets, the referenced files section displays only filenames without their full path. You can still hover on a filename to see the full path.

• Adding Tags - When adding a tag from a specific doc, the list of workspace tags is ordered alphabetically.

Bug fixes:​

• In the GitHub App, when a PR only contains a Swimm doc change without any changes to the code, no Swimm comment will be added to the PR.

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.9.3❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Introducing Tags: You can add tags on each doc and filter your docs by tag in your repos. When a tag is created, it can be used across all of your workspace repositories. You can also rename, remove, or permanently delete a tag from your workspace by going into a doc and then from the sidebar, hover over the tag. Then, click on the "..." menu to manage your options.

• Coverage Goals for Repos: Admin can now set a coverage goal for every repo. Check out the new Insights Tab for more repo coverage data and to set your coverage goals.

• Document Updates Graph: Admins can now see the number of documents that have been updated with Swimm's patented Auto-sync feature.

Improvements:​

• You can now filter documentation by type (docs or Playlists), file name, stage (committed/pending/draft), and tags.

• The Integrations page (available to Swimm admins only) was removed. Instead, you can navigate to the new Integrations & Settings page (contains the same options) from the Home/Repository page via the left sidebar gear icon or via the gear icon next to the repository name.

• Add Smart Tokens from anywhere in your repo: You will now automatically get suggestions for smart tokens - even for code elements that are not in snippets in a doc!

• Preview for Smart Token selection: Get a glimpse of where your tokens are taken. The preview window provides more context for the Smart Token you select.

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.9.2❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Mention a Swimm user from your workspace in a doc via the /mention command or by entering @ followed by the user’s name.
• Watch a doc and get notified when it's been updated.
• New activity graphs in the Admin view. Admins can now track and learn about member activity in a workspace, including daily sessions and number of docs read.

Improvements:​

• Faster navigation - a faster navigation process across the app.
• An Integrations tab is available inside User Settings to install IDE plugins and to connect to Slack in order to receive personal Swimm notifications.
• The document sidebar is now available when editing a doc (in addition to viewing a doc).
• When scrolling through a doc that contains headers, the table of contents section in the sidebar automatically points to the active doc content.
• Additional auto-syncable cases are recognized by Swimm (docs previously marked as out of date are now recognized as auto-syncable).

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.9.1❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

Table of Contents: A new sidebar located on the right side of your screen, is now available when viewing a doc. The sidebar contains a table of contents section, a section showing referenced files,and general doc metadata such as the doc creation date and date last updated. Click on the table of contents entry to navigate to a specific section in the doc.

Improvements:​

GitHub App: When the Swimm Verify Check setting is enabled from the GitHub App settings and a PR includes Swimm doc changes, you will receive a different Check message clarifying that related Swimm docs have been updated.

Bug fixes:​

Fixed bugs in the repo connection process.

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.9.0❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Introducing our new Slack App to make it easier for you and your team to stay updated with Swimm! With the Swimm Slack app, once you connect your repo to a Slack channel, you will automatically be notified whenever a new doc is merged to your default branch. As an admin, just go to the Integrations page and click the Install button next to Slack.
• We now support Documents and Playlists list view. You can view more documents in the list view at once with relevant information in each column. You always have the option to switch back to the previous card layout.
• You can now control personalized email, Slack, and in-app notifications when an important action affecting you occurs. The new notifications area can be accessed from Profile > User Settings > Notifications.

Improvements:​

• App Facelift: We’ve made changes and improvements to Swimm's app including viewing workspace related stats on the Home Page. Note that all of your documents are still available under Everything.
• Removed the Mark as Read button from docs. It is still available inside Playlists.
• Improved the Swimm Editor writing flow
  • Every line is draggable
  • Snippets and images can now be inserted everywhere
• Improved pasting of Markdown and HTML content
  • With new shortcuts (cmd + v and cmd + shift + v)
• Added a contextual menu to each line in the document
• Created new shortcuts moving content up and down (ctrl + shift + up and ctrl + shift + down)

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.8.8❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• Request a Doc: You can now request a doc and assign it to a member of your team. You can find the list of all requested documents in the new “Doc Requests” tab under a repository. Doc requests are marked as completed once they are written.
• Demo Workspace: Check out Swimm's Demo Workspace to get inspired with real documentation written by our engineering team. Access Swimm's Demo Workspace via the Help Center.

Improvements:​

• Enhanced Signup Process: When new users sign up for Swimm, they can now request to join their company's existing workspace. Note that this feature is only available if you sign up with Google.

For further information and any questions, please reach out to us on our Community Slack Channel.

We're pleased to announce the availability of Swimm 0.8.6❗ 🌊🚢🏊🚀🆕💥🎉✨

New features:​

• After reviewing a doc, you can now send a quick thank you to everyone who contributed to creating that document. At the bottom of the document, there are 3 options you can pick: great doc, time-saver, and valuable insights.
• You can assign a doc to a Swimm user or email address via the Assign link located below the document title. You can choose from a predefined set of reasons (needs review, needs updating, FYI, other) and assign it and include an optional note. After assigning a doc, the assignee will receive an email with the assignment details.
• You can obtain and share a direct link to a code snippet with the anchor icon located at the top-right corner of a snippet.
• Introducing a new GitHub App setting called Configure Swimm Verify Check . When enabled, Swimm will fail only when outdated/out of sync docs are caused by your current PR. When disabled (default), Swimm will show updates related to any outdated/out of sync docs.

Improvements:​

• You can see a list of all contributors on a doc (not only the last contributor) when viewing a doc.

A few changes in our editor​

• Slash command "/link" changed into 2 commands: "/doc" and "/playlist" to add links to these items specifically.
• Typing "Enter" creates a new block which results in a more fluid and smooth editing experience.
• A new contextual menu when clicking the block handle icon shows the block options.

Bug fixes:​

• When "Swimm Verify Check" configuration checkbox is enabled with a PR from a side-branch of a side-branch - Swimm Verify didn't behave correctly

For further information and any questions, please reach out to us on our Community Slack Channel.