Quack Companion

This extension guides you through your code contributions with Quack as a companion. The extension provides you with curated contribution guidelines from maintainers and assists you in meeting them.

Quick Tour

Contribution guidance

Once installed, when you open a public GitHub project, the extension will activate like below:

You'll find two main sections (with ongoing development):

• Contribution scoping: everything for you to pick an issue/feature to work on, and ensure it's adequate to the project.
• Guidelines: automatic compliance of contribution guidelines, so that you can avoid the back-and-forth between the PR reviews and your IDE!

Setup

Prerequisites

Install VSCode

Install the extension

Either:

• Follow the instructions on the online VS Marketplace page
• In VSCode, click on Extensions in the sidebar, search for "Quack Companion" and click on "Install"

Roadmap

The ultimate goal for this extension is to offer a smooth contribution experience for any developer. The development efforts will be focused on achieving the following milestones:

• 🤝 Turn contribution guidelines into a live pair coding experience
• 🐣 Help any developer find a starter contribution opportunity
• ⚖️ Ensure alignment between the contribution goal and the project's priorities

Telemetry

Why we collect information

Quack is dedicated to transform the contribution workflow of developers. Developer tools are among the most difficult types of product to build and we need to better understand where to allocate/reduce our efforts over time.

Since we want to keep providing free options for our services in the future, and since we don't want to rely on advertising, we humbly ask you to share limited usage data so that we can improve the products and services that we offer.

What we collect

For each event, here is the largest amount of data we collect:

• Event identifiers: the event type (e.g.fetch-guidelines) and potentially the scope (e.g. the repository)
• User information: depending on the telemetry setting, either your GitHub username or an anonymized UUID specific to you (created when you first activate the extension).

And since the extension is open source, you can navigate the codebase to verify the above information if you feel like it ;)

What you can do about it

This data collection is done using Posthog and can be:

• 😟 anonymized: by default we'll identify your actions with your GitHub username. We'll keep an option to prevent that identification, as we understand it's important for developers to have this choice.
• 😭 disabled: like in most VSCode extensions, you have the ability to disable telemetry completely.

Copying & distribution

Copyright (C) 2023, Quack AI.

This program is licensed under the Apache License 2.0. See LICENSE or go to https://www.apache.org/licenses/LICENSE-2.0 for full license details.

Contributing

Feeling like improving the interface? Or perhaps submitting a new feature idea? Any sort of contribution is greatly appreciated!

You can find a short guide in CONTRIBUTING to help grow this project! And if you're interested, you can join us on