Skip to content
This repository was archived by the owner on Oct 11, 2024. It is now read-only.

Commit 3e09330

Browse files
authored
docs(readme): update README and walkthrough for the release (#70)
* refactor(media): rename assets to media * docs(readme): update repo reference * refactor(webview): update style location * docs: update assets location * ci(github): update labeler * fix(util): avoid redirect on API * docs(readme): update README * docs(walkthrough): update extension walkthrough * docs(changelog): update changelog * build(version): bump version * docs(changelog): update content for release
1 parent dc758b9 commit 3e09330

38 files changed

+98
-142
lines changed

.github/labeler.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
'ext: assets':
1+
'ext: media':
22
- changed-files:
3-
- any-glob-to-any-file: assets/*
3+
- any-glob-to-any-file: media/*
44

55
'module: activation':
66
- changed-files:

.github/verify_labels.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
"topic: build",
3333
"topic: ci",
3434
"topic: style",
35-
"ext: assets",
35+
"ext: media",
3636
"module: activation",
3737
"module: commands",
3838
"module: util",

CHANGELOG.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
## [0.0.7] - 2024-03-28
11+
12+
### Added
13+
14+
- Update readme and walkthroughs (#70)
15+
- Replaces axios with native fetch (#68)
16+
- Update API synchronization to preserve guidelines on remote (#64, #65)
17+
- Revamp guideline view (#63)
18+
- Add multi-turn chat view (#62)
19+
- Remove unused imports (#60)
20+
- Add PR label & title automatic check (#55)
21+
- Add precommit hooks to help contributors (#37)
22+
- Update marketplace metadata (#33)
23+
24+
### Fixed
25+
26+
- Fix the semver convention for package (#59)
27+
1028
## [0.0.6] - 2023-12-15
1129

1230
### Added

CONTRIBUTING.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,10 @@ Whatever the way you wish to contribute to the project, please respect the [code
66

77
## Codebase structure
88

9-
- [`src/`](https://github.com/quack-ai/companion/blob/main/src/) - The actual platform codebase
10-
- [`assets/`](https://github.com/quack-ai/companion/blob/main/assets/) - Binary assets
11-
- [`styles/`](https://github.com/quack-ai/companion/blob/main/styles/) - Style sheet files
12-
- [`.vscode/`](https://github.com/quack-ai/companion/blob/main/.vscode/) - VSCode specific config
13-
- [`.github/`](https://github.com/quack-ai/companion/blob/main/.github/) - Configuration for GitHub workflow
9+
- [`src/`](https://github.com/quack-ai/companion-vscode/blob/main/src/) - The actual platform codebase
10+
- [`media/`](https://github.com/quack-ai/companion-vscode/blob/main/media/) - Binary assets & styling configs
11+
- [`.vscode/`](https://github.com/quack-ai/companion-vscode/blob/main/.vscode/) - VSCode specific config
12+
- [`.github/`](https://github.com/quack-ai/companion-vscode/blob/main/.github/) - Configuration for GitHub workflow
1413

1514
## Continuous Integration
1615

@@ -51,26 +50,26 @@ The file should be placed at the root folder of your local copy of the project.
5150

5251
### Feature requests & bug report
5352

54-
Whether you encountered a problem, or you have a feature suggestion, your input has value and can be used by contributors to reference it in their developments. For this purpose, we advise you to use Github [issues](https://github.com/quack-ai/companion/issues).
53+
Whether you encountered a problem, or you have a feature suggestion, your input has value and can be used by contributors to reference it in their developments. For this purpose, we advise you to use Github [issues](https://github.com/quack-ai/companion-vscode/issues).
5554

5655
First, check whether the topic wasn't already covered in an open / closed issue. If not, feel free to open a new one! When doing so, use issue templates whenever possible and provide enough information for other contributors to jump in.
5756

5857
### Questions
5958

60-
If you are wondering how to do something with Contribution API, or a more general question, you should consider checking out Github [discussions](https://github.com/quack-ai/companion/discussions). See it as a Q&A forum, or the project-specific StackOverflow!
59+
If you are wondering how to do something with Contribution API, or a more general question, you should consider checking out Github [discussions](https://github.com/quack-ai/companion-vscode/discussions). See it as a Q&A forum, or the project-specific StackOverflow!
6160

6261
## Submitting a Pull Request
6362

6463
### Preparing your local branch
6564

66-
1 - Fork this [repository](https://github.com/quack-ai/companion) by clicking on the "Fork" button at the top right of the page. This will create a copy of the project under your GitHub account (cf. [Fork a repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).
65+
1 - Fork this [repository](https://github.com/quack-ai/companion-vscode) by clicking on the "Fork" button at the top right of the page. This will create a copy of the project under your GitHub account (cf. [Fork a repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).
6766

6867
2 - [Clone your fork](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) to your local disk and set the upstream to this repo
6968

7069
```shell
71-
git clone [email protected]:<YOUR_GITHUB_ACCOUNT>/companion.git
72-
cd companion
73-
git remote add upstream https://github.com/quack-ai/companion.git
70+
git clone [email protected]:<YOUR_GITHUB_ACCOUNT>/companion-vscode.git
71+
cd companion-vscode
72+
git remote add upstream https://github.com/quack-ai/companion-vscode.git
7473
```
7574

7675
3 - You should not work on the `main` branch, so let's create a new one

README.md

Lines changed: 25 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,21 @@
22
<a href="https://quack-ai.com"><img src="https://quack-ai.com/quack.png" width="100" height="100"></a>
33
</p>
44
<h1 align="center">
5-
Quack Companion
5+
Quack Companion - IDE extension
66
</h1>
77

88
<p align="center">
9-
<a href="https://github.com/quack-ai/companion">VSCode extension</a> ・
10-
<a href="https://github.com/quack-ai/contribution-api">Backend API</a> ・
11-
<a href="https://github.com/quack-ai/platform">Frontend dashboard</a> ・
9+
<p align="center">
10+
<a href="https://github.com/quack-ai/companion">API</a> ・
11+
<a href="https://github.com/quack-ai/companion-vscode">VSCode extension</a> ・
1212
<a href="https://docs.quackai.com">Documentation</a>
1313
</p>
14+
</p>
1415
<h2 align="center"></h2>
1516

1617
<p align="center">
17-
<a href="https://github.com/quack-ai/companion/actions/workflows/builds.yml">
18-
<img alt="CI Status" src="https://img.shields.io/github/actions/workflow/status/quack-ai/companion/builds.yml?branch=main&label=CI&logo=github&style=flat-square">
18+
<a href="https://github.com/quack-ai/companion-vscode/actions/workflows/builds.yml">
19+
<img alt="CI Status" src="https://img.shields.io/github/actions/workflow/status/quack-ai/companion-vscode/builds.yml?branch=main&label=CI&logo=github&style=flat-square">
1920
</a>
2021
<a href="https://github.com/eslint/eslint">
2122
<img src="https://img.shields.io/badge/Linter-ESLint-4B32C3?style=flat-square&logo=ESLint&logoColor=white" alt="eslint">
@@ -36,43 +37,46 @@
3637
<img src="https://img.shields.io/open-vsx/v/quackai/quack-companion?logo=opensourceinitiative&logoColor=fff&style=flat-square&label=Open%20VSX%20Registry" alt="Open VSX Registry">
3738
</a>
3839
<a href="https://github.com/nodejs/node">
39-
<img src="https://img.shields.io/badge/Node-18-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js">
40+
<img src="https://img.shields.io/badge/Node-20-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js">
4041
</a>
41-
<a href="https://github.com/quack-ai/companion/blob/main/LICENSE">
42+
<a href="https://github.com/quack-ai/companion-vscode/blob/main/LICENSE">
4243
<img src="https://img.shields.io/badge/License-Apache 2.0-blue?style=flat-square" alt="license">
4344
</a>
4445
</p>
4546

4647
<p align="center">
47-
<!-- <a href="https://discord.gg/E9rY3bVCWd">
48-
<img src="https://dcbadge.vercel.app/api/server/E9rY3bVCWd?style=flat" alt="discord"/>
49-
</a> -->
50-
<a target="_blank" href="https://discord.gg/E9rY3bVCWd" style="background:none">
51-
<img src="https://img.shields.io/badge/Discord-join-continue.svg?labelColor=191937&color=6F6FF7&logo=discord" />
48+
<a href="https://discord.gg/E9rY3bVCWd">
49+
<img src="https://img.shields.io/badge/Discord-Community-5865F2?style=flat-square&logo=discord&logoColor=white" />
5250
</a>
5351
<a href="https://twitter.com/quack_ai">
5452
<img src="https://img.shields.io/badge/-@quack_ai-1D9BF0?style=flat-square&logo=twitter&logoColor=white" alt="Twitter">
5553
</a>
5654
</p>
5755

58-
![Compliance hint](assets/compliance_hint.png)
56+
Smart linting and code chat overcharged by your team insights in VSCode
5957

60-
This extension guides you through your code contributions with Quack as a companion. The extension provides curated contribution guidelines from maintainers and assists you in meeting them.
58+
https://github.com/quack-ai/companion-vscode/assets/26927750/019a0610-2bca-48a4-ad35-e0a8241617d5
6159

6260
## Quick Tour
6361

64-
### Contribution guidance
62+
### Code chat
63+
64+
![Code chat](https://github.com/quack-ai/companion-vscode/assets/26927750/0577baa8-e1b8-479a-b63e-939e8d5052be)
6565

66-
![Guideline view](assets/guideline_list.png)
66+
### Coding guideline curation
6767

68-
Once installed, when you open a public GitHub project, the extension will give you a new tab where you'll find:
68+
![Guideline view](https://github.com/quack-ai/companion-vscode/assets/26927750/118eea21-1ef5-42a9-af4c-cb8a1f2c5c3a)
6969

70-
- **Guidelines**: automatic compliance of contribution guidelines, so that you can avoid the back-and-forth between the PR reviews and your IDE!
71-
- **Code chat** (coming soon)
70+
Once installed, when you open a project, the extension will give you a new tab where you'll find:
71+
72+
- **Guideline curation**: curate your software insights with your team
73+
- **Code chat**: ChatGPT but for developers
74+
- **Smart linting** (temporarily disabled)
75+
- **Code completion** (coming soon)
7276

7377
### Walthrough tutorial
7478

75-
![Developer walkthrough](assets/dev_walkthrough.png)
79+
![Developer walkthrough](https://github.com/quack-ai/companion-vscode/assets/26927750/bd4fd595-991f-41d9-a125-f42cf2af6642)
7680

7781
With our walkthrough tutorial, you're only a few clicks away from having your own coding companion.
7882

@@ -129,8 +133,6 @@ Copyright (C) 2023-2024, Quack AI.
129133
This program is licensed under the Apache License 2.0.
130134
See LICENSE or go to <https://www.apache.org/licenses/LICENSE-2.0> for full license details.
131135

132-
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fquack-ai%2Fquack-companion-vscode.svg?type=large&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fquack-ai%2Fquack-companion-vscode?ref=badge_large&issueType=license)
133-
134136
## Contributing
135137

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

assets/compliance_hint.png

-24.8 KB
Binary file not shown.

assets/dev_walkthrough.png

-23.7 KB
Binary file not shown.

assets/editor_view.png

-14.4 KB
Binary file not shown.

assets/guideline_dashboard.png

-82.8 KB
Binary file not shown.

assets/guideline_list.png

-12.2 KB
Binary file not shown.

0 commit comments

Comments
 (0)