markdown-contacts

Extension development

Install project dependencies:
```
bin/set_up_development_environment
```
Debug the extension in VSCode:
1. Run TypeScript compiler: npm run watch.
2. Open src/extension.ts in your editor.
3. Press F5.
4. Once the new VSCode instance is launched, select the Markdown language.
Publish extension:
1. Add last changes to README - ignore commits with version changes and updates to README.md to add release changes.
2. Manually bump version:
```
npm version patch  # major/minor/patch/...
                   # see `npm version --help` for more options
```
  Check published versions if you are unsure about whether you need to bump the version or not.
3. Push latest changes: git push --atomic origin master (to ensure tags are sent simultaneously)
4. Go to CI to monitor deployment. Note: the deployment will fail if there is not a new tag.
(AVOID WHEN POSSIBLE, use CI instead) Manually publish the extension:
1. Set up credentials as environment variables:
  - VSCODE_PUBLISHER_ID: publisher ID, see here for more context.
  - VSCE_PAT: personal access token, follow these instructions to get one.
2. Publish the extension bumping the version:
```
npm run publish minor  # major/minor/patch/...
                       # see `npm version --help` for more options
```
This will bundle the extension with webpack (same as npm run vscode:prepublish) and upload it to the extension marketplace.

...

...

In the global settings (optional):

{
  "markdown-contacts.globalNames": [
    "GlobalName_A",
    "GlobalName_B",
  ],
}

In the workspace settings (optional):

{
  "markdown-contacts.workspaceNames": [
    "NameA",
    "NameB",
  ],
}

Reload VSCode when you change the list of names in the extension settings.

...