Documatic

This extension brings Documatic to VSCode: quickly search your large codebases using simple queries - what does it do? what dependencies does it have? And more.

Documatic search uses AI to link relations between your query and snippets of code, so you don't have to know the exact keywords you're looking for!

Features

• Codesearch
  • Search your codebases using natural questions

See requirements for using the extension and a guide on how to use the extension below. Want more features? Open a feature request! See below for more information.

Requirements

IMPORTANT: To use this extension, you must have an active Documatic account. Sign up for an account here. If you're on the waitlist and would like to get your team onboarded, please contact shane@documatic.com to arrange a call.

On your Documatic account, you must have indexed projects. If you've very recently indexed a new codebase, it takes a couple of minutes for the codebase to become searchable; if you're not getting results, wait a few minutes. If this persists, please contact shane@documatic.com for help. N.b. You currently cannot create Documatic projects via the VSCode extension.

Using the extension

Connecting your account

On the Documatic tab in VSCode, click "sign in". This will take you to the Documatic web platform, where you can sign in. Once you've signed in, you will see your Documatic organisations and projects.

N.b. You currently cannot manage organisations and projects from the extension. Please log in to the Documatic web application to make changes.

Codesearch

To run a search:

• Run the command "Documatic Search" or use the shortcut cmd + K.
• Type in your search in query into the text field and press enter
• Select which project to run your search over (defaults to all projects)
  • The extension shows which projects, if any, are in your active VSCode workspace
• The extension will display the top code snippets in a list
• Click on "view" to be navigated to a code snippet
  • If the project is in your active VSCode workspace, your will be navigated to the code file
  • If the project is not in your workspace, a copy of the code file will be created and opened

N.b. The version of the codebase indexed for search is the main/master branch at time of indexing. Documatic does not index a live version of your codebase. The extension still works on other branches, however changing branches or making updates to the code may result in discrepencies between line numbers when navigating to the code. Documatic reindexes your codebases regularly. If you would like non-main branches to be indexed for your team, please contact shane@documatic.com.

Refreshing your account

If you logged into Documatic on the VSCode app and subsequently added more projects/organisations, you will need to fresh your connection. You can do this by pressing the reload/refresh icon at the top of the Documatic panel, or alternatively by running the command:

1. ctrl+shift+p to bring up the command panel
2. Enter the Documatic: Refresh command

Signing out

If you need to sign out of your Documatic account on VSCode, press the exit icon at the top of the Documatic panel, or alternatively by running the command:

1. ctrl+shift+p to bring up the command panel
2. Enter the Documatic: Clear command

Issues and updates

Known Issues

• Your signed in session can time out on the extension without the UI updating
  • As a temporary work around, clearing your VSCode session can reset this
• On some VSCode versions, an error occurs when running a search
  • Please update your VSCode and restart your system

Bugs and features

If you have found a bug you would like to report or if there is a feature you would added, please open an issue on the public issue tracker.

Security

If you believe you have found a security vulnerability, please do not post details on public channels. Instead, please contact security@documatic.com or shane@documatic.com with details of the vulnerability. For more information, please see SECURITY.md.

Contributing

Contributions are welcome! If you have a bug to report or a feature to request, please feel free to open an issue. If you would like to open a pull request, please refer to the contributing guide

Changelog

For full release notes, please see the complete changelog in the repository.

0.2.1

Fixed a sign-in issue.

0.2.0

Initial release of Documatic's VSCode extension. Comes with codesearch and code snippet analysis.

License

Apache 2.0. Read [the license] for full terms.

About Documatic

Documatic is a startup building tools to help you better understand your code.
Don't ask your boss, ask Documatic.