Skip to content

Collaborate via IDE & UI

Collab functionality enables you to discuss code and documentation easily with the stakeholders via VSCode and UI. Many stakeholders are not comfortable using IDE directly; this functionality enables them also to have a discussion with technical users.

Code Collaboration Workflow

Code Collaboration workflow allows you to discuss code without creating a PR

Start a discussion

You can start a discussion at the file or code block levels (single or multiple lines) by pressing (+) sign next to the code.

StartDiscussion

If you click on the display icon as shown in the image above, you can show details of the discussion previously started

When a discussion is started, the extension generates dbt docs and uploads those docs to the Altimate AI SaaS instance so that non-technical stakeholders can contribute to the discussion via SaaS UI as well.

Add a comment

Once the discussion is started, you can publish a comment and also tag other users from the Altimate AI SaaS instance.

Add comment

If you don't want to tag the user but still want to share the link with them, just copy the link from the comments box, and share it with them manually (Slack, Email etc.)

Email notification (if a user is tagged)

Tagger user receives an email notification with a link to open the discussion in the Altimate AI UI.

Sample Email

Non-technical users can reply to comment via UI

Comment UI

Technical user can see the comment in IDE directly

The technical user who started the discussion in IDE can see the replies from other users directly in the IDE.

List Comments

The discussion can continue from here onwards or it can be resolved by clicking resolve action available on top of the comment textbox. Discussion can be started from a UI also similarly, by clicking on (+) sign next to the code blocks.

Document Collaboration Workflow

Table and column descriptions can also be reviewed and discussed with this functionality.

Start a discussion

Discussion can be started via VSCode in the Documentation Editor panel or from SaaS product UI also from the link shared as covered in code collaboration workflow above.

Doc Discussion

Add a comment

You can add a comment and tag a user to the comment. In that case, that particular user will receive an email notification to open the discussion. Please check the code collaboration workflow for email notification example.

Doc Comment

View all doc discussions

You can view all doc discussion on line no. 1 of the model file, and copy discussion links from there. Click on the display icon shown on the left-hand side of line no. 1.

You can copy the documentation discussion link from here and share it with other users. You can also resolve the discussion as needed.

Doc Comment

Recorded Demo

This feature requires an API key. You can get it by signing up for free at www.altimate.ai