Skip to main content

Swimm 0.9.5 Released

Β· 3 min read
Swimm
Swimm Development Team

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.

Swimm 0.9.4 Released

Β· 2 min read
Swimm
Swimm Development Team

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.

Swimm 0.9.3 Released

Β· 2 min read
Swimm
Swimm Development Team

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.

Swimm 0.9.2 Released

Β· 2 min read
Swimm
Swimm Development Team

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.

Swimm 0.9.1 Released

Β· One min read
Swimm
Swimm Development Team

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.

Swimm 0.9.0 Released

Β· 2 min read
Swimm
Swimm Development Team

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.

Swimm 0.8.8 Released

Β· One min read
Swimm
Swimm Development Team

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.

Swimm 0.8.6 Released

Β· 2 min read
Swimm
Swimm Development Team

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.

Swimm 0.8.4 Released

Β· One min read
Swimm
Swimm Development Team

We're pleased to announce the availability of Swimm 0.8.4❗ πŸŒŠπŸš’πŸŠπŸš€πŸ†•πŸ’₯πŸŽ‰βœ¨

Improvements:​

  • Performance enhancements when connecting a repo to Swimm.
  • Auto-sync performance enhancements when viewing or editing a doc.
  • When viewing a doc, the last contributor is displayed in addition to the doc creator.
  • When viewing the Workspace Member's List and hovering over a user's name, the user's email is displayed.

Bug fixes:​

  • Fixed missing repos issue.
  • Long branch names are correctly displayed via a tooltip.

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

Swimm 0.8.2 Released

Β· One min read
Swimm
Swimm Development Team

We're pleased to announce the availability of Swimm 0.8.2❗ πŸŒŠπŸš’πŸŠπŸš€πŸ†•πŸ’₯πŸŽ‰βœ¨

New features:​

  • You can set your snippet view's default to be expanded or collapsed.
  • Swimm GitHub App: You can now configure Swimm to automatically create a draft from your latest PR and show you Swimm Recommended Docs. Go to your repo’s GitHub App Settings and enable the new Allow Swimm the option to add a comment with Swimm Recommended Docs checkbox under Customize PR Comments.
  • You can join the Swimm Community channel from within the Help section.

Improvements:​

  • Performance boost for opening a document and Playlist.
  • Auto-complete suggestion supports tokens with -, :, and \.

Bug fixes:​

  • Tokens that are copy pasted are rendered properly.
  • Swimm will automatically save a draft when a Smart Path is approved or reselected.

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