Add /SOURCELINK linker option

Author: Colin Robertson

docs/build/reference/sourcelink.md

@@ -0,0 +1,46 @@
+---
+title: "/SOURCELINK (Include Sourcelink file in PDB) | Microsoft Docs"
+ms.custom: ""
+ms.date: "08/20/2018"
+ms.technology: ["cpp-tools"]
+ms.topic: "reference"
+f1_keywords: ["/sourcelink"]
+dev_langs: ["C++"]
+helpviewer_keywords: ["/SOURCELINK linker option", "/SOURCELINK"]
+author: "corob-msft"
+ms.author: "corob"
+ms.workload: ["cplusplus"]
+---
+# /SOURCELINK (Include Sourcelink file in PDB)
+
+Specifies a SourceLink configuration file to include in the PDB file generated by the linker.
+
+## Syntax
+
+> **/SOURCELINK**[__:__*filename*]
+
+## Arguments
+
+*filename*  
+Specifies a JSON-formatted configuration file that contains a simple mapping of local file paths to URLs where the source file can be retrieved for display by the debugger. For more information on the format of this file, see [Source Link JSON Schema](https://github.com/dotnet/designs/blob/master/accepted/diagnostics/source-link.md#source-link-json-schema).
+
+## Remarks
+
+SourceLink is a language- and source-control agnostic system for providing first-class source debugging experiences for binaries. SourceLink is supported for native C++ binaries starting in Visual Studio 2017 version 15.7. For an overview of SourceLink, see [Source Link](https://github.com/dotnet/designs/blob/master/accepted/diagnostics/source-link.md). For information on how to use SourceLink in your projects and how to generate the SourceLink file, see [Using SourceLink](https://github.com/dotnet/sourcelink#using-sourcelink).
+
+### To set the /SOURCELINK linker option in Visual Studio
+
+1. Open the **Property Pages** dialog box for the project. For more information, see [Working with Project Properties](../../ide/working-with-project-properties.md).
+
+1. Select the **Configuration Properties** > **Linker** > **Command Line** property page.
+
+1. In the **Additional options** box, add **/SOURCELINK:**_filename_ and then choose **OK** or **Apply** to save your changes.
+
+### To set this linker option programmatically  
+  
+- This option does not have a programmatic equivalent.
+
+## See also
+
+[Setting Linker Options](../../build/reference/setting-linker-options.md)  
+[Linker Options](../../build/reference/linker-options.md)