The bookmarklets in this directory are browser shortcuts that may help with reviewing GitHub documentation. We may eventually build the functionality they provide into Docs review environments, but these are handy hacks for now.

For each bookmarklet described below, create a new bookmark in your browser with a descriptive name, open the JavaScript file and copy its contents, and paste the JavaScript as the bookmark's URL.

Clicking the bookmark will then execute the JavaScript.

⚠️ For Safari, you'll need to do the following:

1. Go to Safari > Preferences > Advanced and enable Show Develop menu in menu bar.
2. Go to Develop and enable Allow JavaScript from Smart Search field.

src/bookmarklets/view-in-development.js

When you're looking at a page on docs.github.com, clicking this bookmarklet will load the same path you're viewing but on your local server running at localhost:4000.

src/bookmarklets/view-in-production.js

When you're looking at a page on your local server running at localhost:4000, clicking this bookmarklet will load the same path you're viewing but on the live documentation site at docs.github.com.

src/bookmarklets/open-in-vscode.js

When you're looking at a page on either docs.github.com, review, or localhost:4000, clicking this bookmarklet will open the source Markdown file from your local checkout in VS Code.

The installation requires a few steps:

1. Copy the contents of src/bookmarklets/open-in-vscode.js.
2. Browse to https://chriszarate.github.io/bookmarkleter/ and paste the code into the box.
3. Find the path of your local checkout of the docs repo you want to open files from (for example, /Users/<USERNAME>/repos/docs).
4. Paste the path in place of where it says REPLACE_ME in line 1 (make sure to leave the single quotes around it).
5. Change the title to something like Open in VSC.
6. Drag the generated link onto your bookmarks bar.