Merge pull request #1993 from asb3993/amburns-contentvalidationfixes

Content validation fixes

Author: TrishaMc

mac/asp-net-core.md

@@ -139,7 +139,7 @@ To add a controller, do the following:
 
 2. Add the following code to the new controller:
 
-    ```
+    ```csharp
     using System;
     using Microsoft.AspNetCore.Mvc;
     using System.Text.Encodings.Web;
@@ -228,6 +228,6 @@ Make sure to complete all four steps successfully to ensure that .NET Core is in
 
 This guide gave an introduction to ASP.NET Core. It describes what it is, when to use it, and provided information on using it in Visual Studio for Mac.
 For more information on the next steps from here, refer to the following guides:
-- [ASP.NET Core](https://docs.microsoft.com/aspnet/core/#build-web-ui-and-web-apis-using-aspnet-core-mvc) docs.
+- [ASP.NET Core](https://docs.microsoft.com/aspnet/core/?view=aspnetcore-2.1#build-web-ui-and-web-apis-using-aspnet-core-mvc) docs.
 - [Creating Backend Services for Native Mobile Applications](https://docs.microsoft.com/aspnet/core/mobile/native-mobile-backend), which shows how to build a REST service using ASP.NET Core for a Xamarin.Forms app.
 - [ASP.NET Core hands-on lab](https://github.com/Microsoft/vs4mac-labs/tree/master/Web/Getting-Started).

mac/configurations.md

@@ -1,5 +1,5 @@
 ---
-title: "Understanding Build Configurations in Visual Studio for Mac"
+title: "Understanding Build Configurations"
 description: "This article describes the various build configurations in Visual Studio for Mac"
 author: asb3993
 ms.author: amburns

mac/connected-services.md

@@ -1,7 +1,6 @@
 ---
 title: "Connected Services"
 description: "Add Azure data storage, authentication, and push notifications to mobile apps from within Visual Studio for Mac"
-ms.prod: xamarin
 ms.assetid: 41CB62FF-0F39-4CE8-8917-6A77F058719F
 author: asb3993
 ms.author: amburns

mac/create-new-projects.md

@@ -1,5 +1,5 @@
 ---
-title: "Creating new Projects and Solutions Visual Studio for Mac"
+title: "Creating new Projects and Solutions"
 description: "This article describes how to create projects and solutions in Visual Studio for Mac"
 author: asb3993
 ms.author: amburns
@@ -28,7 +28,7 @@ This method of adding new projects can be used to take advantage of Xamarin code
 
 The landing page of Visual Studio displays a list of recent projects that you have been working on:
 
- ![](media/create-new-projects-recent.png)
+ ![Recent solutions section on welcome page](media/create-new-projects-recent.png)
 
 You can filter this list using the Filter box or remove individual items from the list. 
 

mac/customizing-build-system.md

@@ -24,25 +24,25 @@ MSBuild uses an XML file, called a project file, that defines the *Items* that a
 
 Locate the MSBuild file by right-clicking on your project name and selecting **Reveal in Finder**. The finder window displays all the files and folders related to your project, including the `.csproj` file, as illustrated in the following image:
 
-![](media/customizing-build-system-image1.png)
+![csproj location in Finder](media/customizing-build-system-image1.png)
 
 To display the `.csproj` in a new tab in Visual Studio for Mac, right-click on your project name and browse to **Tools > Edit File**:
 
-![](media/customizing-build-system-image2.png)
+![opening the csproj in the source editor](media/customizing-build-system-image2.png)
 
 ### Composition of the MSBuild file
 
 All MSBuild files contain a mandatory root `Project` element, like so:
 
-```
+```xml
 <?xml version="1.0" encoding="utf-8"?>
 <Project ToolsVersion="14.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
 </Project>
 ```
 
 Typically, the project will also import a `.targets` file. This file contains many of the rules that describe how to process and build the various files. The import usually appear towards the bottom of your `proj` file, and for C# projects look something like this:
 
-```
+```xml
 <Import Project="$(MSBuildBinPath)\Microsoft.CSharp.targets" />
 ```
 
@@ -60,7 +60,7 @@ They are set using a PropertyGroup and can contain any number of PropertiesGroup
 
 For example, the PropertyGroup for a simple console application might look like the following XML:
 
-```
+```xml
 <PropertyGroup>
 		<Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
 		<Platform Condition=" '$(Platform)' == '' ">x86</Platform>
@@ -82,7 +82,7 @@ Items are created by declaring an `ItemGroup`. There can be any number of ItemGr
 
 For example, the following code snippet creates the iOS Launch Screens. The Launch Screens have the build type `BundleResource`, with the spec as the path to the image:
 
-```
+```xml
  <ItemGroup>
     <BundleResource Include="Resources\Default-568h%402x.png" />
     <BundleResource Include="Resources\Default%402x.png" />
@@ -92,7 +92,7 @@ For example, the following code snippet creates the iOS Launch Screens. The Laun
     <BundleResource Include="Resources\Default-Landscape%402x.png" />
   </ItemGroup>
  ```
- 
+
  Item sets can be referred to from expressions using the `@()` syntax. For example, `@(BundleResource)` will be evaluated as the BundleResource item set, which means all of the BundleResource items. If there are no items of this type, it will be empty, without any error.
 
 ## Resources for learning MSBuild
@@ -101,5 +101,3 @@ The following resources can be used to learn about MSBuild in more detail:
 
 * [MSDN - Overview](https://msdn.microsoft.com/library/dd393574.aspx)
 * [MSDN - Concepts](https://msdn.microsoft.com/library/dd637714.aspx)
-
-

mac/editorconfig.md

@@ -69,7 +69,7 @@ If you're working with a project or solution that already contains an `.editorco
 
 You may want to reuse an existing `.editorconfig` file in your project. To add an existing file, you first need to display hidden files in Finder by entering the following command in **Terminal**:
 
-```
+```bash
 $ defaults write com.apple.Finder AppleShowAllFiles true
 $ killall Finder
 ```

mac/nuget-walkthrough.md

@@ -1,5 +1,5 @@
 ---
-title: "Walkthrough - Including a NuGet package in your project"
+title: "Including a NuGet package in your project"
 description: This document covers how to include a NuGet package in a Xamarin project. It walks through finding and downloading a package, as well as introducing the IDE integration features.
 author: asb3993
 ms.author: amburns
@@ -23,8 +23,6 @@ First, create a project named `HelloNuget` as illustrated below. This example sh
 
 ![Create new iOS Project](media/nuget-walkthrough-NewProject.png)
 
-<a name="Adding_a_Package" class="injected"></a>
-
 ## Adding a Package
 
 With the project open in Visual Studio for Mac, right-click on the **Packages** folder in the **Solution Pad** and select **Add Packages...**:
@@ -46,18 +44,19 @@ Use the search box in the top-right corner to find a specific package, for examp
 
 Once the package has been downloaded it will be added to your project. The solution will change as follows:
 
-*   The **References** node will contain a list of all the assemblies that are part of a NuGet package.
-*   The **Packages** node displays each NuGet package that you have downloaded. You can update or remove a package from this list.
-*   A **packages.config** file will be added to the project. This XML file is used by the IDE to track which package versions are referenced in this project. This file should not be hand-edited, but you should keep it in version control. Note that a project.json file can be used instead of a packages.config file. The project.json file is a new package file format introduced with NuGet 3, which supports transitive restore. More detailed information on project.json can be found in the [NuGet documentation](http://docs.microsoft.com/NuGet/Schema/Project-Json). The project.json file needs to be added manually and the project closed and re-opened before the project.json file is used in Visual Studio for Mac.
+* The **References** node will contain a list of all the assemblies that are part of a NuGet package.
+* The **Packages** node displays each NuGet package that you have downloaded. You can update or remove a package from this list.
+* A **packages.config** file will be added to the project. This XML file is used by the IDE to track which package versions are referenced in this project. This file should not be hand-edited, but you should keep it in version control. Note that a project.json file can be used instead of a packages.config file. The project.json file is a new package file format introduced with NuGet 3, which supports transitive restore. More detailed information on project.json can be found in the [NuGet documentation](http://docs.microsoft.com/NuGet/Schema/Project-Json). The project.json file needs to be added manually and the project closed and re-opened before the project.json file is used in Visual Studio for Mac.
 
 ## Using NuGet Packages
 
 Once the NuGet package has been added and the project references updated you can program against the APIs as you would with any project reference.
 
 Ensure that you add any required `using` directives to the top of your file:
 
-
-    using Newtownsoft.json;
+```csharp
+using Newtownsoft.json;
+```
 
 Most NuGet provide additional information, such as a README or Project page link to the Nuget source. You can normally find a link to this in the package blurb on the Add Packages page:
 

mac/projects-and-solutions.md

@@ -2,7 +2,8 @@
 title: "Projects and Solutions"
 description: This document provides an overview of Projects and Solutions in Visual Studio for Mac.
 author: asb3993
-ms.author: amburns05/06/201804/14/2017
+ms.author: amburns
+ms.date: 05/06/2018
 ms.assetid: 8254505D-D96E-48BD-8A5E-CF6A917897EA
 ---
 # Projects and Solutions

mac/set-up-subversion-repository.md

@@ -1,6 +1,6 @@
 ---
 title: Setting Up a Subversion Repository
-description: Using Git and Subversion in Visual Studio for Mac.
+description: Using Subversion in Visual Studio for Mac.
 author: asb3993
 ms.author: amburns
 ms.date: 05/06/2018
@@ -9,33 +9,45 @@ ms.assetid: 0D58FB37-530E-495B-BED6-FD499477A9B6
 
 # Setting up a Subversion repository
 
-Subversion is a centralized version control system. This means that there is a single server that contains all files and revisions from which users can check out any version of any file. When files are checked out from a remote Subversion repository, the user will get a snapshot of the repository at that point in time.
+Subversion is a centralized _version control system_, meaning that there's a single server that contains all files and revisions, from which users can check out any version of any file. When files are checked out from a remote Subversion repository, the user gets a snapshot of the repository at that point in time.
 
-Before starting to use Subversion, the Xcode command line tools must be installed as they include the correct svn packages. You can check that SVN is installed in Terminal with the following command:
+To use Subversion for your version control, it must be installed on your machine. To check if Subversion is installed your machine, use the following command in Terminal:
 
-`svn h`
+```bash
+svn --version
+```
+
+This command returns the version number.
+
+If Subversion isn't already installed, the easiest way to get it is by installing the _Xcode Command Line Tools_. Use the command below to install Xcode Command Line Tools and Subversion.
+
+```bash
+xcode-select --install
+```
+
+Once Subversion is installed on your machine, use the following steps to publish your project in SVN.
 
 1. Create a free SVN repository online. For this example, [Assembla](https://app.assembla.com/) was used. Once created, a URL will be provided, which will be used to connect to the repository: 
 
-    ![Obtain SVN URL and copy it](media/version-control-subversion1-sml.png)
+    ![copy the SVN URL](media/version-control-subversion1-sml.png)
 
 2. Open or create a Visual Studio for Mac Project.
 
 3. Right click on the Project and select **Version Control > Publish in Version Control...**: 
 
     ![Start Publishing Project](media/version-control-subversion2.png)
 
-4. In the **Connect to Repository** tab, select **Subversion** from the top drop down.
+4. In the **Connect to Repository** tab, select **Subversion** from the top drop-down.
 
-5. Enter the URL from step 1. This should populate the other fields by default: 
+5. Enter the URL from step 1. Once the URL is entered, the other fields are populated by default: 
 
     ![Select Repository and Enter details Dialog](media/version-control-subversion3.png)
 
 7. Click **OK** and then confirm by pressing **Publish**.
 
-7. You might be prompted to enter your credentials for the site on which you create the repository. Enter these as illustrated below:
+7. If prompted, enter your credentials for the site on which you create the repository, as illustrated below:
 
-    ![](media/version-control-subversion5.png)
+    ![Entering credentials for subversion repo](media/version-control-subversion5.png)
 
 8.	All the version control commands available should now be visible in the version control menu.
 

mac/signing-in.md

@@ -36,5 +36,5 @@ To sign in to Visual Studio for Mac, do the following steps:
 
 Visual Studio for Mac supports adding multiple accounts to your personalization account. These additional accounts will allow you to access resources, such as Azure, from any added account. 
 
-To add additional user accounts, follow the steps in the [How to sign in to Visual Studio for Mac](#How_to_sign_in_to_Visual_Studio_for_Mac) section.
+To add additional user accounts, follow the steps in the [How to sign in to Visual Studio for Mac](#how-to-sign-in-to-visual-studio-for-mac) section.
 

mac/source-editor.md

@@ -21,7 +21,6 @@ Viewing and moving efficiently throughout code is an integral part of the develo
 
 Visual Studio for Mac offers many powerful features to make cross-platform development as accessible and as useful as possible. The following sections describe some of the highlights.
 
-
 ## Code folding
 
 Code folding makes it easier to manage large source code files by allowing developers to show or hide complete sections of code, such as using directives, boilerplate code and comments, and #region statements. Code folding is turned off by default in Visual Studio for Mac
@@ -58,25 +57,20 @@ The option to show tabs, spaces, and line endings is also available:
 
  ![whitespace displayed](media/source-editor-image22.png)
 
-
 ## Ruler
 
 The column ruler is useful for determining line lengths, particularly when working on a team that has line length guidelines. The column ruler can be turned on or off by navigating to **Visual Studio > Preferences... > Text Editor > Markers and Rulers** and selecting (or deselecting) **Show Column ruler**, as illustrated in the following image:
 
- ![](media/source-editor-image5.png)
+ ![Preferences dialog with "show column ruler" highlighted](media/source-editor-image5.png)
 
  This displays as a vertical light gray line in the source editor.
 
-
 ## Highlight identifier references
 
 With the "Highlight identifier references" option is enabled, you can select any symbol in the source code and the source editor will provide a visual guide to all other references in that file. To turn on this option, go to **Visual Studio > Preferences... > Text Editor > Markers and Rulers** and select _Highlight identifier references_, as illustrated in the following image:
 
-![](media/source-editor-image6.png)
+![Preferences dialog with "Highlight identifier references" highlighted](media/source-editor-image6.png)
 
 The color of the highlight is also useful for denoting that something is being assigned or referenced. If something is assigned, it is highlighted in red; if it is referenced, it is highlighted in blue:
 
-![](media/source-editor-image7.png)
-
-
-
+![example showing color of higlight](media/source-editor-image7.png)

mac/task-comments.md

@@ -15,7 +15,7 @@ When writing code, it is standard practice to explicitly comment unfinished or q
 
 To add a new task comment, add a comment that includes the task keyword. For example:
 
-```
+```csharp
 //TODO: Finish this for all properties.
 ```
 

mac/troubleshooting.md

@@ -23,7 +23,7 @@ When an exception has been caught, an exception bubble will appear. To view more
 
 This will display the **Show Details** dialog, providing more information regarding the exception:
 
-![](media/troubleshooting-image3.png)
+![Show details dialog](media/troubleshooting-image3.png)
 
 Important sections of the dialog, which are numbered above are described in detail below:
 

mac/version-control.md

@@ -19,7 +19,7 @@ Subversion is a centralized version control system, which means that there is a
 
 Git is a distributed version control system that allows teams to work on the same documents simultaneously. With Git there might be a single server that contains all the files, but the entire repository is cloned locally to your machine whenever a repository is checked out from this central source.
 
-# Basic Concepts 
+## Basic Concepts 
 
 Visual Studio for Mac provides support for both Git and Subversion version control systems. The following articles explore setting up Git and Subversion repositories through Visual Studio for Mac, as well as simple functionality such as reviewing, committing, and pushing changes.