Consistency for macOS

Fixes #1561

CONTRIBUTING.md

@@ -135,7 +135,7 @@ When you link to an image, the path and filename are case-sensitive.  The conven
 
 ### Key bindings
 
-The VS Code portal is able to show the correct key bindings depending on the reader's operating system (Mac, Windows or Linux).
+The VS Code portal is able to show the correct key bindings depending on the reader's operating system (macOS, Windows or Linux).
 
 To enable this for keyboard shortcuts, use the format `kb(workbench.action.files.openFile)` where the command name is included in parentheses.
 

README.md

@@ -8,7 +8,7 @@ If you are looking for the VS Code product GitHub repository, you can find it [h
 
 ## Visual Studio Code
 
-[VS Code](https://code.visualstudio.com/) is a lightweight but powerful development environment for building and debugging modern web and cloud applications.  It is free and available on your favorite platform - Linux, Mac and Windows.
+[VS Code](https://code.visualstudio.com/) is a lightweight but powerful development environment for building and debugging modern web and cloud applications.  It is free and available on your favorite platform - Linux, macOS and Windows.
 
 If you landed here looking for other information about VS Code, head over to [our website](https://code.visualstudio.com) for additional information.
 

docs/editor/accessibility.md

@@ -93,7 +93,7 @@ VS Code has some known accessibility issues depending on the platform.
 
 You can not use the keyboard (right, left arrow keys) to move between top-level menu items (**File**, **Edit**, **View**, etc).  This is due to Electron issue [#2504](https://github.com/atom/electron/issues/2504).
 
-### Mac
+### macOS
 
 There is limited screen reader support for the editor with VoiceOver.
 

docs/editor/codebasics.md

@@ -63,7 +63,7 @@ Place the cursor in one corner and then hold `kbstyle(Shift+Alt)` while dragging
 
 Note: This changes to `kbstyle(Shift+Ctrl/Cmd)` when using `kbstyle(Ctrl/Cmd)` as [multi-cursor modifier](#multi-cursor-modifier).
 
-There are also default key bindings for column selection on Mac and Windows, but not on Linux.
+There are also default key bindings for column selection on macOS and Windows, but not on Linux.
 
 Key|Command|Command id
 ---|-------|----------

docs/editor/debugging.md

@@ -384,7 +384,7 @@ To write your own debugger extension, visit:
 
 **Q: What are the supported debugging scenarios?**
 
-**A:** Debugging of Node.js based applications is supported on Linux, Mac, and Windows out of the box with VS Code. Many other scenarios are supported by [VS Code extensions](https://marketplace.visualstudio.com/vscode/Debuggers?sortBy=Downloads) available on the Marketplace.
+**A:** Debugging of Node.js based applications is supported on Linux, macOS, and Windows out of the box with VS Code. Many other scenarios are supported by [VS Code extensions](https://marketplace.visualstudio.com/vscode/Debuggers?sortBy=Downloads) available on the Marketplace.
 
 **Q: I do not see any launch configurations in the debug view drop down, what is wrong?**
 

docs/editor/extension-gallery.md

@@ -183,7 +183,7 @@ Once you've downloaded an extension, you can side load it by renaming the `.zip`
 **A**: Extensions are installed in your extensions folders. Depending on your platform, the global location is in the following folders:
 
 * **Windows** `%USERPROFILE%\.vscode\extensions`
-* **Mac** `~/.vscode/extensions`
+* **macOS** `~/.vscode/extensions`
 * **Linux** `~/.vscode/extensions`
 
 **Q: Can VS Code read TextMate bundles directly?**

docs/editor/integrated-terminal.md

@@ -158,13 +158,13 @@ This can be configured using the `terminal.integrated.rightClickBehavior` settin
 
 The Integrated Terminal has basic find functionality which can be triggered with `kb(workbench.action.terminal.focusFindWidget)`.
 
-If you want `Ctrl+F` to go to the shell instead of launching the Find widget on Linux and Windows, you will need to remove the keybinding like so:
+If you want `kbstyle(Ctrl+F)` to go to the shell instead of launching the Find widget on Linux and Windows, you will need to remove the keybinding like so:
 
 ```js
 // Windows/Linux
 { "key": "ctrl+f", "command": "-workbench.action.terminal.focusFindWidget",
                       "when": "terminalFocus" },
-// Mac
+// macOS
 { "key": "cmd+f",  "command": "-workbench.action.terminal.focusFindWidget",
                       "when": "terminalFocus" },
 ```

docs/editor/tasks-appendix.md

@@ -28,7 +28,7 @@ interface TaskConfiguration extends BaseTaskConfiguration {
     windows?: BaseTaskConfiguration;
 
     /**
-     * Mac specific task configuration
+     * macOS specific task configuration
      */
     osx?: BaseTaskConfiguration;
 

docs/editor/tasks-v1-appendix.md

@@ -28,7 +28,7 @@ interface TaskConfiguration extends BaseTaskConfiguration {
 	windows?: BaseTaskConfiguration;
 
 	/**
-	 * Mac specific task configuration
+	 * macOS specific task configuration
 	 */
 	osx?: BaseTaskConfiguration;
 

docs/editor/tasks-v1.md

@@ -191,7 +191,7 @@ Below is an example that uses the Node.js executable as a command and is treated
 }
 ```
 
-Valid operating properties are `windows` for Windows, `linux` for Linux and `osx` for Mac. Properties defined in an operating system specific scope override properties defined in the global scope.
+Valid operating properties are `windows` for Windows, `linux` for Linux and `osx` for macOS. Properties defined in an operating system specific scope override properties defined in the global scope.
 
 In the example below:
 

docs/editor/tasks.md

@@ -489,7 +489,7 @@ If you only need to tweak it for a specific task then add the OS specific comman
 }
 ```
 
-If the task is execute in `PowerShell` the command needs to read like this `chcp 866; more russian.txt`. Under Linux and Mac the `locale` command can be used to inspect the locale and tweak the necessary environment variables.
+If the task is execute in `PowerShell`, the command needs to read like this `chcp 866; more russian.txt`. On Linux and macOS, the `locale` command can be used to inspect the locale and tweak the necessary environment variables.
 
 ## Examples of tasks in action
 

docs/editor/versioncontrol.md

@@ -59,7 +59,7 @@ If there is no upstream branch configured and the Git repository has remotes set
 
 **Staging** and **unstaging** can be done via contextual actions in the files or by drag-and-drop.
 
-You can type a commit message above the changes and press `kbstyle(Ctrl+Enter)` (Mac: `kbstyle(⌘+Enter)`) to commit them. If there are any staged changes, only those will be committed, otherwise all changes will be committed.
+You can type a commit message above the changes and press `kbstyle(Ctrl+Enter)` (macOS: `kbstyle(⌘+Enter)`) to commit them. If there are any staged changes, only those will be committed, otherwise all changes will be committed.
 
 We've found this to be a great workflow. For example, in the previous screenshot, only the `config.js` file will be included in the commit. A consecutive commit action would commit both `vinyl-zip.js` and `tests.js` in a separate commit.
 
@@ -141,7 +141,7 @@ Here are the steps to do so:
 
 1. Make sure you can run `code --help` from the command line and you get help.
     * if you do not see help, please follow these steps:
-        * Mac: Select **Shell Command: Install 'Code' command in path** from the **Command Palette**.
+        * macOS: Select **Shell Command: Install 'Code' command in path** from the **Command Palette**.
         * Windows: Make sure you selected **Add to PATH** during the installation.
         * Linux: Make sure you installed Code via our new .deb or .rpm packages.
 2. From the command line, run `git config --global core.editor "code --wait"`

docs/editor/whyvscode.md

@@ -17,7 +17,7 @@ First and foremost, it is an editor that gets out of your way. The delightfully
 
 Visual Studio Code supports macOS, Linux, and Windows - so you can hit the ground running, no matter the platform.
 
-![Visual Studio Code runs on Mac, Linux and Windows](images/whyvscode/macwinlinux2.png)
+![Visual Studio Code runs on macOS, Linux and Windows](images/whyvscode/macwinlinux2.png)
 
 ## Edit, build, and debug with ease
 

docs/extensionAPI/extension-points.md

@@ -215,13 +215,13 @@ Contribute a key binding rule defining what command should be invoked when the u
 
 Contributing a key binding will cause the Default Keyboard Shortcuts to display your rule, and every UI representation of the command will now show the key binding you have added. And, of course, when the user presses the key combination the command will be invoked.
 
->**Note:** Because VS Code runs on Windows, Mac and Linux, where modifiers differ, you can use "key" to set the default key combination and overwrite it with a specific platform.
+>**Note:** Because VS Code runs on Windows, macOS and Linux, where modifiers differ, you can use "key" to set the default key combination and overwrite it with a specific platform.
 
 >**Note:** When a command is invoked (from a key binding or from the Command Palette), VS Code will emit an activationEvent `onCommand:${command}`.
 
 ### Example
 
-Defining that `kbstyle(Ctrl+F1)` under Windows and Linux and `kbstyle(Cmd+F1)` under Mac trigger the `"extension.sayHello"` command:
+Defining that `kbstyle(Ctrl+F1)` under Windows and Linux and `kbstyle(Cmd+F1)` under macOS trigger the `"extension.sayHello"` command:
 
 ```json
 "contributes": {

docs/extensionAPI/patterns-and-principles.md

@@ -124,11 +124,8 @@ You can create a `.vscodeignore` file to exclude some files from being included
 
 **Q: Can I use native Node.js modules with my extension?**
 
-**A:** A Visual Studio Code extension package contains all of its dependencies. This means that if you develop your extension on Windows and depend on a native Node.js module when you publish that extension, the Windows compiled native dependency will be contained in your extension. Users on Mac or Linux won't be able to use the extension.
+**A:** A Visual Studio Code extension package contains all of its dependencies. This means that if you develop your extension on Windows and depend on a native Node.js module when you publish that extension, the Windows compiled native dependency will be contained in your extension. Users on macOS or Linux won't be able to use the extension.
 
-The only way to make this work for now is to include binaries for all four platforms of VS Code (Windows x86 and x64, Linux, Mac) in your extension and have code that dynamically loads the right one.
+The only way to make this work for now is to include binaries for all four platforms of VS Code (Windows x86 and x64, Linux, macOS) in your extension and have code that dynamically loads the right one.
 
 We don't recommend extensions use native `npm` modules as native modules bundled with an extension must be recompiled with every new version of VS Code against the same Node.js version that VS Code ships with. You can find the Node.js and module versions by running `process.versions` from the developer tools console (**Help** > **Toggle Developer Tools**).
-
-
-

docs/extensions/developing-extensions.md

@@ -80,7 +80,7 @@ compilation. When the compilation is complete with no errors, you must reload th
 your changes. You have two options to do this:
 
 * Click on the Debug view **Restart** action to relaunch the **Extension Development Host** window.
-* Press `kbstyle(Ctrl+R)` (Mac: `kbstyle(Cmd+R)`) in the Extension Development Host window.
+* Press `kbstyle(Ctrl+R)` (macOS: `kbstyle(Cmd+R)`) in the Extension Development Host window.
 
 ## Profiling your extension
 

docs/extensions/example-hello-world.md

@@ -247,7 +247,7 @@ Create a file (**File** > **New File**), type some text and select it. When you
 So far, the extension you have written only runs in a special instance of VS Code, the Extension Development instance. To get your extension running in all instances of VS Code, you need to copy it to a new folder under your local extensions folder:
 
 * Windows: `%USERPROFILE%\.vscode\extensions`
-* Mac/Linux: `$HOME/.vscode/extensions`
+* macOS/Linux: `$HOME/.vscode/extensions`
 
 ## Publishing your extension
 

docs/extensions/example-word-count.md

@@ -49,7 +49,7 @@ code .
 
 Before we go on, we can run the extension to make sure everything works as expected by pressing `kb(workbench.action.debug.start)`. As you saw in the previous "Hello World" walkthrough, VS Code opens another window (the **[Extension Development Host]** window) in which your extension will be loaded. You should find the "Hello World" command in the Command Palette (press `kb(workbench.action.showCommands)`) and when you select it, you will see an information box at the top of the window saying "Hello World".
 
-Now that you have confirmed that the extension is running properly, you can keep the extension development window open if you like. To test out any changes that you make to your extension, you can either press `kb(workbench.action.debug.continue)` again in the development window or reload the extension development window by pressing `kbstyle(Ctrl+R)` (Mac: `kbstyle(Cmd+R)`).
+Now that you have confirmed that the extension is running properly, you can keep the extension development window open if you like. To test out any changes that you make to your extension, you can either press `kb(workbench.action.debug.continue)` again in the development window or reload the extension development window by pressing `kbstyle(Ctrl+R)` (macOS: `kbstyle(Cmd+R)`).
 
 ## Update the Status Bar
 

docs/extensions/testing-extensions.md

@@ -120,8 +120,7 @@ script:
   - npm test --silent
 ```
 
-The script above will run the tests on both Linux and Mac. Note that in order to run the tests on Linux, you need to have
-a `before_install` configuration as above to enable Linux to start VS Code from the build.
+The script above will run the tests on both Linux and macOS. Note that in order to run the tests on Linux, you need to have a `before_install` configuration as above to enable Linux to start VS Code from the build.
 
 There are some optional environment variables to configure the test runner:
 

docs/extensions/themes-snippets-colorizers.md

@@ -313,7 +313,7 @@ If you want to share user snippets, you'll need to package your snippet json fil
 Depending on your platform, your user snippets file is located here:
 
 - **Windows** `%APPDATA%\Code\User\snippets\(language).json`
-- **Mac** `$HOME/Library/Application Support/Code/User/snippets/(language).json`
+- **macOS** `$HOME/Library/Application Support/Code/User/snippets/(language).json`
 - **Linux** `$HOME/.config/Code/User/snippets/(language).json`
 
 where `(language).json` depends on the targeted language of the snippets (e.g. `markdown.json` for Markdown snippets).  Create a new folder for your extension and copy your snippet file to a `snippets` subdirectory.

docs/extensions/yocode.md

@@ -105,7 +105,7 @@ Once created, open VS Code on the created folder and run the extension to test t
 To load an extension, you need to copy the files to your VS Code extensions folder `.vscode/extensions`. Depending on your platform, it is located in the following folders:
 
 * **Windows** `%USERPROFILE%\.vscode\extensions`
-* **Mac** `~/.vscode/extensions`
+* **macOS** `~/.vscode/extensions`
 * **Linux** `~/.vscode/extensions`
 
 If you want to load your extension each time VS Code runs, copy your project ('side loading') to a new folder under `.vscode/extensions`. For example: `~/.vscode/extensions/myextension`.

docs/getstarted/keybindings.md

@@ -16,7 +16,7 @@ Visual Studio Code lets you perform most tasks directly from the keyboard.  This
 
 ## Keyboard Shortcuts Editor
 
-Visual Studio Code provides a rich and easy keyboard shortcuts editing experience using **Keyboard Shortcuts** editor. It lists all available commands with and without keybindings and you can easily change / remove / reset their keybindings using the available actions. It also has a search box on the top that helps you in finding commands or keybindings. You can open this editor by going to the menu under **File**  > **Preferences** > **Keyboard Shortcuts**. (**Code** > **Preferences** > **Keyboard Shortcuts** on Mac)
+Visual Studio Code provides a rich and easy keyboard shortcuts editing experience using **Keyboard Shortcuts** editor. It lists all available commands with and without keybindings and you can easily change / remove / reset their keybindings using the available actions. It also has a search box on the top that helps you in finding commands or keybindings. You can open this editor by going to the menu under **File**  > **Preferences** > **Keyboard Shortcuts**. (**Code** > **Preferences** > **Keyboard Shortcuts** on macOS)
 
 ![Keyboard Shortcuts](images/keybinding/keyboard-shortcuts.gif)
 
@@ -110,7 +110,7 @@ The following modifiers are accepted:
 
 Platform|Modifiers
 --|---------
-Mac|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(cmd+)`
+macOS|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(cmd+)`
 Windows|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(win+)`
 Linux|`kbstyle(ctrl+)`, `kbstyle(shift+)`, `kbstyle(alt+)`, `kbstyle(meta+)`
 

docs/getstarted/settings.md

@@ -66,7 +66,7 @@ Below is a [copy of the default settings](/docs/getstarted/settings.md#default-s
 Depending on your platform, the user settings file is located here:
 
 * **Windows** `%APPDATA%\Code\User\settings.json`
-* **Mac** `$HOME/Library/Application Support/Code/User/settings.json`
+* **macOS** `$HOME/Library/Application Support/Code/User/settings.json`
 * **Linux** `$HOME/.config/Code/User/settings.json`
 
 The workspace setting file is located under the `.vscode` folder in your root folder.
@@ -1558,7 +1558,7 @@ Below are the Visual Studio Code default settings and their values. You can also
 
 **Q: VS Code says "Unable to write settings."**
 
-**A:** If you try to change a setting (for example turning on Auto Save or selecting a new Color Theme) and you see "Unable to write settings. Please open User Settings to correct errors/warnings in the file and try again.", it means your `settings.json` file is ill-formed or has errors. The errors can be as simple as a missing comma or setting value. Open the Settings editor **File** > **Preferences** > **Settings** (**Code** > **Preferences** > **Settings** on Mac) (`kb(workbench.action.openGlobalSettings)`) and you should see the error highlighted with red squiggles.
+**A:** If you try to change a setting (for example turning on Auto Save or selecting a new Color Theme) and you see "Unable to write settings. Please open User Settings to correct errors/warnings in the file and try again.", it means your `settings.json` file is ill-formed or has errors. The errors can be as simple as a missing comma or setting value. Open the Settings editor **File** > **Preferences** > **Settings** (**Code** > **Preferences** > **Settings** on macOS) (`kb(workbench.action.openGlobalSettings)`) and you should see the error highlighted with red squiggles.
 
 **Q: When does it make sense to use workspace settings?**
 

docs/getstarted/themes.md

@@ -25,7 +25,7 @@ The current color theme is configured in the [settings](/docs/getstarted/setting
 
 However, there is no need to edit the settings directly. It's easier to use the Color Theme Picker to preview and select a theme.
 
-1. Open the Color Theme picker with **File** > **Preferences** > **Color Theme**. (**Code** > **Preferences** > **Color Theme** on Mac)
+1. Open the Color Theme picker with **File** > **Preferences** > **Color Theme**. (**Code** > **Preferences** > **Color Theme** on macOS)
 2. Use the cursor keys to preview the colors of the theme.
 3. Select the theme you want and hit `kbstyle(Enter)`.
 
@@ -108,7 +108,7 @@ The current File Icon theme is persisted in your user [settings](/docs/getstarte
 
 There is no need to edit the `settings.json` file directly. It is better to use the File Icon Theme picker to preview and select a theme.
 
-1. Open the Icon Theme picker with **File** > **Preferences** > **File Icon Theme**. (**Code** > **Preferences** > **File Icon Theme** on Mac)
+1. Open the Icon Theme picker with **File** > **Preferences** > **File Icon Theme**. (**Code** > **Preferences** > **File Icon Theme** on macOS)
 2. Use the cursor keys to preview the icons of the theme.
 3. Select the theme you want and hit `kbstyle(Enter)`.
 

docs/getstarted/userinterface.md

@@ -33,18 +33,18 @@ Open files in each editor are displayed with tabbed headers (Tabs) at the top of
 
 You can have up to three editors open side by side. If you already have one editor open, there are multiple ways of opening another editor to the side of the existing one:
 
-* `kbstyle(Ctrl)` (Mac: `kbstyle(Cmd)`) click on a file in the Explorer.
+* `kbstyle(Ctrl)` (macOS: `kbstyle(Cmd)`) click on a file in the Explorer.
 * `kb(workbench.action.splitEditor)` to split the active editor into two.
 * **Open to the Side** from the Explorer context menu on a file.
 * Click the **Split Editor** button in the upper right of an editor.
 * Drag and drop a file to the either side of the editor region.
-* `kbstyle(Ctrl+Enter)` (Mac: `kbstyle(Cmd+Enter)`) in the **Quick Open** (`kb(workbench.action.quickOpen)`) file list.
+* `kbstyle(Ctrl+Enter)` (macOS: `kbstyle(Cmd+Enter)`) in the **Quick Open** (`kb(workbench.action.quickOpen)`) file list.
 
 ![Side by Side editing](images/userinterface/sidebyside.png)
 
 Whenever you open another file, the editor that is active will display the content of that file. So if you have two editors side by side and you want to open file 'foo.cs' into the right hand editor, make sure that editor is active (by clicking inside it) before opening file 'foo.cs'.
 
-When you have more than one editor open you can switch between them quickly by holding the `kbstyle(Ctrl)` (Mac: `kbstyle('Cmd')`) key and pressing `kbstyle(1)`, `kbstyle(2)`, or `kbstyle(3)`.
+When you have more than one editor open you can switch between them quickly by holding the `kbstyle(Ctrl)` (macOS: `kbstyle('Cmd')`) key and pressing `kbstyle(1)`, `kbstyle(2)`, or `kbstyle(3)`.
 
 >**Tip:** You can resize editors and reorder them. Drag and drop the editor title area to reposition or resize the editor.
 
@@ -74,9 +74,9 @@ After opening a folder in VS Code, the contents of the folder are shown in the E
 
 ![Explorer Menu](images/userinterface/explorer_menu.png)
 
-VS Code works very well with other tools that you might use, especially command-line tools. If you want to run a command-line tool in the context of the folder you currently have open in VS Code, right-click the folder and select **Open in Command Prompt** (or **Open in Terminal** on Mac or Linux).
+VS Code works very well with other tools that you might use, especially command-line tools. If you want to run a command-line tool in the context of the folder you currently have open in VS Code, right-click the folder and select **Open in Command Prompt** (or **Open in Terminal** on macOS or Linux).
 
-You can also navigate to the location of a file or folder in the native Explorer by right-clicking on a file or folder and selecting **Reveal in Explorer** (or **Reveal in Finder** on the Mac or **Open Containing Folder** on Linux).
+You can also navigate to the location of a file or folder in the native Explorer by right-clicking on a file or folder and selecting **Reveal in Explorer** (or **Reveal in Finder** on the macOS or **Open Containing Folder** on Linux).
 
 >**Tip:** Type `kb(workbench.action.quickOpen)` (**Quick Open**) to quickly search and open a file by its name.
 
@@ -164,7 +164,7 @@ Most editor configurations are kept in settings which can be modified directly.
 * Select **File** > **Preferences** > **Settings** (or press `kb(workbench.action.openGlobalSettings)`) to edit the user `settings.json` file.
 * To edit workspace settings, select the **WORKSPACE SETTINGS** tab to edit the workspace `settings.json` file.
 
->**Note for Mac users:** The **Preferences** menu is under **Code** not **File**. For example, **Code** > **Preferences** > **Settings**.
+>**Note for macOS users:** The **Preferences** menu is under **Code** not **File**. For example, **Code** > **Preferences** > **Settings**.
 
 ![workspace settings](images/userinterface/workspace-settings.png)
 
@@ -286,7 +286,7 @@ Edit your [keybindings](/docs/getstarted/keybindings.md) and add the following:
 
 If you liked the behavior of VS Code closing an entire group when closing one editor, you can bind the following in your [keybindings](/docs/getstarted/keybindings.md).
 
-Mac:
+macOS:
 
 ```json
 { "key": "cmd+w", "command": "workbench.action.closeEditorsInGroup" }

docs/languages/java.md

@@ -11,7 +11,7 @@ MetaDescription: Learn about Visual Studio Code editor features (code completion
 
 The Java support in VS Code is provided through [extensions](/docs/editor/extension-gallery.md) and optimized for lightweight Java projects with a simple, modern workflow. Popular extensions in the [Marketplace](https://marketplace.visualstudio.com) provide essential language features such as project support, code completion, linting, debugging, testing, code formatting, snippets, as well as tooling integration including Maven and Tomcat.
 
-> [Download VS Code](/download) - If you haven't downloaded VS Code yet, quickly install for your platform (Windows, Mac, Linux).
+> [Download VS Code](/download) - If you haven't downloaded VS Code yet, quickly install for your platform (Windows, macOS, Linux).
 
 ## Install Java Extensions
 

docs/languages/tsql.md

@@ -13,7 +13,7 @@ Turn Visual Studio Code into a powerful editor for [Transact-SQL]  (T-SQL) devel
 
 Connect to SQL databases, type T-SQL code, execute T-SQL code, view results, and save results as JSON or CSV files. While typing T-SQL code, you get rich T-SQL language features like T-SQL IntelliSense (code completion), syntax highlighting, linting, code navigation and code snippets.
 
-> [Download VS Code] - If you haven't downloaded VS Code yet, quickly install for your platform (Linux, Mac or Windows).
+> [Download VS Code] - If you haven't downloaded VS Code yet, quickly install for your platform (Linux, macOS or Windows).
 
 ## Install T-SQL support
 

docs/other/dotnet.md

@@ -13,7 +13,7 @@ MetaTags:
 ---
 # Using .NET Core in Visual Studio Code
 
-[.NET Core](https://docs.microsoft.com/en-us/dotnet/articles/welcome) gives you a blazing fast and modular platform for creating server applications that run on Windows, Linux and Mac. Use Visual Studio Code with the C# extension to get a powerful editing experience with full support for C# IntelliSense (smart code completion) and debugging.
+[.NET Core](https://docs.microsoft.com/en-us/dotnet/articles/welcome) gives you a blazing fast and modular platform for creating server applications that run on Windows, Linux and macOS. Use Visual Studio Code with the C# extension to get a powerful editing experience with full support for C# IntelliSense (smart code completion) and debugging.
 
 ## Getting Started
 

docs/python/editing.md

@@ -34,7 +34,7 @@ To enable IntelliSense for packages that are installed in other, non-standard lo
     "C:/Program Files (x86)/Google/google_appengine/lib" ]
 ```
 
-**Mac/Linux:**
+**macOS/Linux:**
 
 ```json
 "python.autoComplete.extraPaths": [

docs/python/environments.md

@@ -89,10 +89,13 @@ If Visual Studio Code does not automatically locate an interpreter you want to u
 For example:
 
 - Windows:
+
   ```json
   "python.pythonPath": "c:/python36/python.exe"
   ```
-- Mac/Linux:
+
+- macOS/Linux:
+
   ```json
   "python.pythonPath": "/home/python36/python"
   ```
@@ -120,7 +123,7 @@ To use a Python interpreter that's installed in a virtual environment:
     }
     ```
 
-    Mac/Linux:
+    macOS/Linux:
     ```json
     {
         "python.pythonPath": "/home/xxx/dev/ala/venv/bin/python"

docs/python/linting.md

@@ -134,7 +134,7 @@ The Python extension maps pep8 message categories to VS Code categories through
 
 ### Command-line arguments and configuration files
 
-Flake8 user options are read from the `.flake8` (Windows) or `~/.config/flake8` (Mac/Linux) file.
+Flake8 user options are read from the `.flake8` (Windows) or `~/.config/flake8` (macOS/Linux) file.
 
 At the project level, options are read from the `[flake8]` section of a `tox.ini` or `setup.cfg` file. Only the first file is considered. For details, see [flake8 Configuration](http://flake8.pycqa.org/en/latest/user/configuration.html).
 

docs/setup/mac.md

@@ -1,17 +1,17 @@
 ---
 Order: 3
 Area: setup
-TOCTitle: Mac
+TOCTitle: macOS
 ContentId: EEADB50A-F5E3-41E9-89DA-35F165196691
-PageTitle: Running Visual Studio Code on Mac
+PageTitle: Running Visual Studio Code on macOS
 DateApproved: 4/5/2018
-MetaDescription: Get Visual Studio Code up and running on Mac.
+MetaDescription: Get Visual Studio Code up and running on Mac (macOS).
 ---
-# Running VS Code on Mac
+# Running VS Code on macOS
 
 ## Installation
 
-1. [Download Visual Studio Code](https://go.microsoft.com/fwlink/?LinkID=534106) for Mac.
+1. [Download Visual Studio Code](https://go.microsoft.com/fwlink/?LinkID=534106) for macOS.
 2. Double-click on the downloaded archive to expand the contents.
 3. Drag `Visual Studio Code.app` to the `Applications` folder, making it available in the `Launchpad`.
 4. Add VS Code to your Dock by right-clicking on the icon and choosing `Options`, `Keep in Dock`.
@@ -23,7 +23,7 @@ You can also run VS Code from the terminal by typing 'code' after adding it to t
 - Launch VS Code.
 - Open the **Command Palette** (`kb(workbench.action.showCommands)`) and type 'shell command' to find the **Shell Command: Install 'code' command in PATH** command.
 
-![Mac shell commands](images/mac/shell-command.png)
+![macOS shell commands](images/mac/shell-command.png)
 
 - Restart the terminal for the new `$PATH` value to take effect. You'll be able to type 'code .' in any folder to start editing files in that folder.
 
@@ -42,7 +42,7 @@ EOF
 
 Out of the box VS Code adds actions to navigate in editor history as well as the full Debug tool bar to control the debugger on your Touch Bar:
 
-![Mac Touch Bar](images/mac/touchbar.gif)
+![macOS Touch Bar](images/mac/touchbar.gif)
 
 ## Updates
 
@@ -50,7 +50,7 @@ VS Code ships monthly [releases](/updates) and supports auto-update when a new r
 
 ## Preferences Menu
 
-You can configure VS Code through [settings](/docs/getstarted/settings.md), [color themes](/docs/getstarted/themes.md) and [custom keybindings](/docs/getstarted/keybindings.md) and you will often see mention in our documentation of the **File** > **Preferences** menu group.  On a Mac, the **Preferences** menu group is under **Code**, not **File**.
+You can configure VS Code through [settings](/docs/getstarted/settings.md), [color themes](/docs/getstarted/themes.md) and [custom keybindings](/docs/getstarted/keybindings.md) and you will often see mention in our documentation of the **File** > **Preferences** menu group.  On a macOS, the **Preferences** menu group is under **Code**, not **File**.
 
 ## Next Steps
 

docs/setup/setup-overview.md

@@ -14,11 +14,11 @@ Getting up and running with Visual Studio Code is quick and easy. It is a small
 
 ## Cross platform
 
-VS Code is a free code editor which runs on the Mac, Linux and Windows operating systems.
+VS Code is a free code editor which runs on the macOS, Linux and Windows operating systems.
 
 Follow the platform specific guides below:
 
-* [Mac](/docs/setup/mac.md)
+* [macOS](/docs/setup/mac.md)
 * [Linux](/docs/setup/linux.md)
 * [Windows](/docs/setup/windows.md)
 
@@ -78,7 +78,7 @@ If you'd like to get something running quickly, try the [Node.js tutorial](/docs
 
 **Q: How do I know which version I'm running?**
 
-**A:** On Linux and Windows, choose **Help** > **About**. On Mac, use **Code** > **About Visual Studio Code**.
+**A:** On Linux and Windows, choose **Help** > **About**. On macOS, use **Code** > **About Visual Studio Code**.
 
 **Q: Why is VS Code saying my installation is corrupt?**
 

docs/supporting/faq.md

@@ -31,7 +31,7 @@ For bugs, feature requests or to contact an extension author, you should use the
 
 You can find the VS Code version information in the About dialog box.
 
-On a Mac, go to **Code** > **About Visual Studio Code**.
+On macOS, go to **Code** > **About Visual Studio Code**.
 
 On Windows and Linux, go to **Help** > **About**.
 
@@ -39,7 +39,7 @@ The VS Code version is the first **Version** number listed and has the version f
 
 ## How do I opt out of VS Code auto-updates?
 
-By default, VS Code is set up to auto-update for Mac and Windows users when we release new updates. If you do not want to get automatic updates, you can set the `update.channel` setting from `default` to `none`.
+By default, VS Code is set up to auto-update for macOS and Windows users when we release new updates. If you do not want to get automatic updates, you can set the `update.channel` setting from `default` to `none`.
 
 To modify the update channel, go to **File** > **Preferences** > **Settings** and add the `update.channel` setting with the value `"none"`.
 

release-notes/v0_8_0.md

@@ -37,7 +37,7 @@ Open the Color Theme picker with `File | Preferences | Color Theme` and use the
 
 
 ## Debugging - No Mono Dependency for Node
-We have ported the implementation of the Node.js debugging support from C#/Mono to TypeScript/Node.js, eliminating our Mono dependency for debugging Node.js applications on OSX and Linux.
+We have ported the implementation of the Node.js debugging support from C#/Mono to TypeScript/Node.js, eliminating our Mono dependency for debugging Node.js applications on macOS and Linux.
 
 
 ## Debugging - Debug Console

release-notes/v1_19.md

@@ -426,7 +426,7 @@ Last but certainly not least, a big *__Thank You!__* to the following folks that
   * Displaying Repository URL (Git Link) on Extensions Page. [PR #31487](https://github.com/Microsoft/vscode/pull/31487)
 * [Fabio Spampinato (@fabiospampinato)](https://github.com/fabiospampinato): Uninstall extensions given paths to their .vsix files [PR #34042](https://github.com/Microsoft/vscode/pull/34042)
 * [Felix Becker (@felixfbecker)](https://github.com/felixfbecker)
-  * Fix OSX builds [PR #37564](https://github.com/Microsoft/vscode/pull/37564)
+  * Fix macOS builds [PR #37564](https://github.com/Microsoft/vscode/pull/37564)
   * Make npm logs less verbose in CI [PR #37566](https://github.com/Microsoft/vscode/pull/37566)
 * [Joel Kuntz (@Frozenfire92)](https://github.com/Frozenfire92):  Fix #39867 fix git popStash type check [PR #39868](https://github.com/Microsoft/vscode/pull/39868)
 * [Sanders Lauture (@golf1052)](https://github.com/golf1052):  Show preview tag on extension page if extension is in preview [PR #36261](https://github.com/Microsoft/vscode/pull/36261)

release-notes/v1_6.md

@@ -562,7 +562,7 @@ Last but certainly not least, a big *__Thank You!__* to the following folks that
 * [Nic Holthaus (@nholthaus)](https://github.com/nholthaus): Add `konsole` as default terminal for KDE-plasma [PR #11452](https://github.com/Microsoft/vscode/pull/11452)
 * [Paul Oppenheim (@pauloppenheim)](https://github.com/pauloppenheim): vscode-linux-*-build-deb - expected permission bits [PR #11558](https://github.com/Microsoft/vscode/pull/11558)
 * [@Romanito](https://github.com/Romanito): Enable "Open with Code" on drive roots in Windows Explorer [PR #11870](https://github.com/Microsoft/vscode/pull/11870)
-* [@sprinkle131313](https://github.com/sprinkle131313): Fixes debugger config launch for Linux and OSX. [PR #11092](https://github.com/Microsoft/vscode/pull/11092)
+* [@sprinkle131313](https://github.com/sprinkle131313): Fixes debugger config launch for Linux and macOS. [PR #11092](https://github.com/Microsoft/vscode/pull/11092)
 * [@ted-piotrowski](https://github.com/ted-piotrowski): Fix gulp methods for targeting arm systems [PR #12486](https://github.com/Microsoft/vscode/pull/12486)
 * [Vincenzo Chianese (@XVincentX)](https://github.com/XVincentX)
   * Provide a changelog tab when this file is bundled in the package [PR #12035](https://github.com/Microsoft/vscode/pull/12035)