Swimm lets you easily select code parts from many files and document them together as a single flow. Review collected by and hosted on G2.com.

The IDE plugin for IntelliJ is not very useful and needs improvement. Review collected by and hosted on G2.com.

Linking doc to code snippet.

Easy markdown language.

Enforcing changes on doc when the code changes. Review collected by and hosted on G2.com.

No option to link snippet on other docs (although you can add link to the full doc) Review collected by and hosted on G2.com.

Easy to use. It requires a small learning curve like any other platform, but once you got it, you can document complex flows and more in minimum time. Review collected by and hosted on G2.com.

Code selection UX, once you select some lines, you get kind of a "jump", I think it can be improved. Review collected by and hosted on G2.com.

The fact that my code remains clean of comments and the documentation lives in a separate space, yet it's linked to every piece of code I desire.

Also, the fact that Swimm allows you to keep the documentation up to date is amazing. Review collected by and hosted on G2.com.

The native app is cumbersome and a little slow.

Its interaction with the IDE plugins is still lackluster.

Ideally, I would want a fully functional web UI (SaaS-like). Review collected by and hosted on G2.com.

User-friendly and easy to use, makes it easier to document each manifest on GitHub. I really like it, it helps our team to explain what each code does and so on Review collected by and hosted on G2.com.

After navigating to Swimm from the Github page it does not turn back when I click the back tab. And the limit of users for the free version is too small I think Review collected by and hosted on G2.com.

I like the format of the docs and the git integration Review collected by and hosted on G2.com.

The fact that you can't search for keywords Review collected by and hosted on G2.com.

That it is super fun to use and the use case is extremely relevant.

I especially appreciate the "Playlist" feature that allows me to dynamically document the codebase spread across multiple services and repositories. Review collected by and hosted on G2.com.

I don't think there are many downsides to using Swimm; it forces you and your team to take documentation seriously, which is always a good thing in the long term. I definitely have feature requests though, so that I could use Swimm even more effectively. Review collected by and hosted on G2.com.

Two-way documentation syncing: code links to documentation in VS Code; snippet documentation dynamically links to code and responds to code changes Review collected by and hosted on G2.com.

The markdown editor is a little bit clunky. It feels like an incomplete copy of Notion's markdown editor. My advice: Just go the whole way. Whatever Notion's editor does, copy down to the T. For example, dragging to re-order code or text blocks. Review collected by and hosted on G2.com.

It syncs up with our github repos and it makes it easy to find a code snippet and create a document for it. It also is pretty intelligent when there are changes to the documentation that may need updating. Review collected by and hosted on G2.com.

Overall it does what I expect. One feature I wanted to see was a search bar for our files which I saw was recently integrated. Review collected by and hosted on G2.com.

The ability to block code changes that make documentation obsolete or outdated.

Right at the start, we knew we'd integrate Swimm in our Ci/CD process to ensure our documentation stays awesome. Review collected by and hosted on G2.com.

Lacking multi-repo documentation on single units (although has another alternative as solution for now) Review collected by and hosted on G2.com.