freeCodeCamp/docs/courses-vscode-extension.md

51 lines
1.4 KiB
Markdown
Raw Normal View History

# Courses VSCode Extension
This details the maintenance guidelines for the [freeCodeCamp/courses-vscode-extension](https://github.com/freeCodeCamp/courses-vscode-extension) repository which contains the source code for the [freeCodeCamp - Courses](https://marketplace.visualstudio.com/items?itemName=freeCodeCamp.freecodecamp-courses) extension.
## Publishing the Extension
A GitHub Action automagically publishes the extension to the Visual Studio Marketplace, on pushes to the `prod` branch.
Ensure the `main` branch is checked out.
```bash
git checkout main
```
Update the local repository with `upstream`, and reset `main`.
```bash
git fetch upstream
git reset --hard upstream/main
```
Checkout the `prod` branch.
```bash
git checkout prod
```
Merge the commits wanted for deployment into `prod`.
```bash
git merge main
```
Push the local branch to `upstream`.
```bash
git push upstream
```
> [!NOTE]
> Pushing to `upstream` requires write access to the `freeCodeCamp/courses-vscode-extension` repository.
## Manually Publishing the Extension
A manual upload to the Visual Studio Marketplace can be achieved, by following these steps:
1. Visit https://marketplace.visualstudio.com/ and sign in
2. Navigate to the [freeCodeCamp Publisher page](https://marketplace.visualstudio.com/manage/publishers/freecodecamp)
3. Select the relevant extension, and select `Update`
4. Upload the file from your local files