Skip to content

Commit

Permalink
Updates for publishing extension.
Browse files Browse the repository at this point in the history
  • Loading branch information
jason-bloomerang committed Dec 21, 2020
1 parent 9db14f3 commit 81970d4
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 63 deletions.
63 changes: 10 additions & 53 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,65 +1,22 @@
# debug-in-titlebar README
#### [Repository](https://github.com/EverlastEngineering/debugInTitlebar)  |  [Issues](https://github.com/EverlastEngineering/debugInTitlebar/issues)

This is the README for your extension "debug-in-titlebar". After writing up a brief description, we recommend including the following sections.
*Frustrated by wanting immediate access to the debug controls?* Using the toolbar floating always means _something_ gets hidden by it, so this extension was born while half-paying attention to a Google Meet.

## Features
Once installed, go to your Preferences and search for `debug toolbar` and set to docked or hidden to prevent that floating toolbar from wrecking your flow.

Describe specific features of your extension including screenshots of your extension in action. Image paths are relative to this README file.
This extension reveals the controls here:

For example if there is an image subfolder under your extension project workspace:
![Screenshot](images/feature.png)

\!\[feature X\]\(images/feature-x.png\)
There is also an additional control, the Toggle Breakpoints button, which isn't normally visible in the toolbar. This is handy when you are in the midst of a deep dive into code and want to "just run the darn thing" without nuking all your breakpoints. Toggle, play, and toggle back for next time.

> Tip: Many popular extensions utilize animations. This is an excellent way to show off your extension! We recommend short, focused animations that are easy to follow.
# Known Issues

## Requirements
The "Toggle All Breakpoints" button isn't state-aware of the existing breakpoints Enable/Disable button, and currently can't be as VSCode doesn't expose that as a parameter. It just means that the first time you click this extension's Toggle button they might already be disabled. Click it again, and all will work.

If you have any requirements or dependencies, add a section describing those and how to install and configure them.

## Extension Settings

Include if your extension adds any VS Code settings through the `contributes.configuration` extension point.

For example:

This extension contributes the following settings:

* `myExtension.enable`: enable/disable this extension
* `myExtension.thing`: set to `blah` to do something

## Known Issues

Calling out known issues can help limit users opening duplicate issues against your extension.
Also, no icons show titlebar until a file is open.

## Release Notes

Users appreciate release notes as you update your extension.

### 1.0.0

Initial release of ...

### 1.0.1

Fixed issue #.

### 1.1.0

Added features X, Y, and Z.

-----------------------------------------------------------------------------------------------------------

## Working with Markdown

**Note:** You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:

* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux)
* Toggle preview (`Shift+CMD+V` on macOS or `Shift+Ctrl+V` on Windows and Linux)
* Press `Ctrl+Space` (Windows, Linux) or `Cmd+Space` (macOS) to see a list of Markdown snippets

### For more information

* [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
* [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)

**Enjoy!**
Initial release. No plans for additional features at this time.
Binary file added images/feature.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
38 changes: 28 additions & 10 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,14 +1,28 @@
{
"name": "debug-in-titlebar",
"displayName": "Debug In Titlebar",
"description": "Moves the debug controls into the titlebar.",
"version": "0.0.1",
"publisher": "EverlastEngineering",
"displayName": "Debug Controls In Titlebar",
"description": "Shows the debug controls into the titlebar.",
"version": "1.0.0",
"engines": {
"vscode": "^1.52.0"
},
"categories": [
"Debuggers",
"Other"
],
"icon": "images/icon.png",
"galleryBanner": {
"color": "#220033",
"theme": "dark"
},
"keywords": [
"debug",
"controls",
"toolbar",
"titlebar",
"docked"
],
"activationEvents": [
"onCommand:debug-in-titlebar.debug-restart",
"onCommand:debug-in-titlebar.debug-pause",
Expand Down Expand Up @@ -92,38 +106,38 @@
{
"command": "debug-in-titlebar.debug-continue",
"group": "navigation@1999901",
"when": "debuggersAvailable &&inDebugMode && debugState == 'stopped'"
"when": "debuggersAvailable && inDebugMode && debugState == 'stopped'"
},
{
"command": "debug-in-titlebar.debug-stepOver",
"group": "navigation@1999903",
"when": "debuggersAvailable"
"when": "debuggersAvailable && inDebugMode"

},
{
"command": "debug-in-titlebar.debug-stepInto",
"group": "navigation@1999904",
"when": "debuggersAvailable"
"when": "debuggersAvailable && inDebugMode"
},
{
"command": "debug-in-titlebar.debug-stepOut",
"group": "navigation@1999905",
"when": "debuggersAvailable"
"when": "debuggersAvailable && inDebugMode"
},
{
"command": "debug-in-titlebar.debug-restart",
"group": "navigation@1999907",
"when": "debuggersAvailable"
"when": "debuggersAvailable && inDebugMode"
},
{
"command": "debug-in-titlebar.debug-stop",
"group": "navigation@1999908",
"when": "debuggersAvailable"
"when": "debuggersAvailable && inDebugMode"
},
{
"command": "debug-in-titlebar.debug-toggleBreakpoints",
"group": "navigation@1999908",
"when": "debuggersAvailable"
"when": "debuggersAvailable && inDebugMode"
}
]
}
Expand All @@ -148,5 +162,9 @@
"mocha": "^8.1.3",
"typescript": "^4.1.2",
"vscode-test": "^1.4.1"
},
"repository": {
"type": "git",
"url": "https://github.com/EverlastEngineering/debugInTitlebar.git"
}
}

0 comments on commit 81970d4

Please sign in to comment.