update docs links

MacCollectionNew/Readme.md

@@ -1,6 +1,6 @@
 ---
 name: Xamarin.Mac - MacCollectionNew
-description: Source code for the Collection Views documentation on Xamarin Developer Center Uses Xamarin.Mac. This project covers working with Data Binding and...
+description: This project covers working with Data Binding and new version of the Collection View API on macOS.
 page_type: sample
 languages:
 - csharp
@@ -10,8 +10,19 @@ urlFragment: maccollectionnew
 ---
 # MacCollectionNew
 
-Source code for the [Collection Views](/guides/mac/user-interface/working-with-collection-views/) documentation on [Xamarin Developer Center](http://docs.xamarin.com)
+Source code for the [Collection Views](https://docs.microsoft.com/xamarin/mac/user-interface/collection-view) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin)
 
-Uses [Xamarin.Mac](http://xamarin.com).
+This project covers working with Data Binding and new version of the Collection View API (`NSCollectionView`)
 
-This project covers working with Data Binding and new version of the Collection View API (`NSCollectionView`) 
+![Mac app with collection view](Screenshots/01.png)
+
+## Prerequisites
+
+* Mac computer with the latest version of macOS.
+* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
+* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple.
+
+## Running the sample
+
+1. Open the solution file (**.sln**) in Visual Studio for Mac.
+1. Use the **Run** button or menu to start the app.

MacControls/Readme.md

@@ -10,12 +10,23 @@ urlFragment: maccontrols
 ---
 # MacControls
 
-Source code for the [Standard Controls](/guides/mac/user-interface/standard-controls/) documentation on [Xamarin Developer Center](http://docs.xamarin.com)
-
-Uses [Xamarin.Mac](http://xamarin.com).
+Source code for the [Standard Controls]https://docs.microsoft.com/xamarin/mac/user-interface/standard-controls) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin)
 
 When working with C# and .NET in a Xamarin.Mac application, you have access to the same Standard AppKit Controls that a developer working in in *Objective-C* and *Xcode* does.
 
 AppKit Controls are the UI Elements that are used to create the User Interface of your Xamarin.Mac application. They consist of elements such as Buttons, Labels, Text Fields, Check Boxes and Segmented Controls and cause instant actions or visible results when a user manipulates them.
 
-This sample application covers working with the standard AppKit controls such as Buttons, Labels, Text Fields, Check Boxes and Segmented Controls in a Xamarin.Mac application. 
+This sample application covers working with the standard AppKit controls such as Buttons, Labels, Text Fields, Check Boxes and Segmented Controls in a Xamarin.Mac application.
+
+![Mac app showing various control types](Screenshots/01.png)
+
+## Prerequisites
+
+* Mac computer with the latest version of macOS.
+* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
+* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple.
+
+## Running the sample
+
+1. Open the solution file (**.sln**) in Visual Studio for Mac.
+1. Use the **Run** button or menu to start the app.

MacDatabase/Readme.md

@@ -10,8 +10,19 @@ urlFragment: macdatabase
 ---
 # MacDatabase
 
-Source code for the [Working with SQLite Databases](/guides/mac/application_fundamentals/databases/) documentation on [Xamarin Developer Center](http://docs.xamarin.com)
+Source code for the [Working with SQLite Databases](https://docs.microsoft.com/xamarin/mac/app-fundamentals/databases) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin)
 
-Uses [Xamarin.Mac](http://xamarin.com).
+This project covers working with SQLite Databases through direct access and Data Binding and Key-Value Coding in a Xamarin.Mac application. It also covers using the SQLite.Net ORM to read and write SQLite data that will be displayed in a Table View.
 
-This project covers working with SQLite Databases through direct access and Data Binding and Key-Value Coding in a Xamarin.Mac application. It also covers using the SQLite.Net ORM to read and write SQLite data that will be displayed in a Table View.
+![Mac table showing database data](Screenshots/01.png)
+
+## Prerequisites
+
+* Mac computer with the latest version of macOS.
+* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
+* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple.
+
+## Running the sample
+
+1. Open the solution file (**.sln**) in Visual Studio for Mac.
+1. Use the **Run** button or menu to start the app.

MacDatabinding-Storyboard/Readme.md

@@ -1,6 +1,6 @@
 ---
 name: Xamarin.Mac - MacDatabinding Storyboard
-description: Source code for the Data Binding and Key-Value Coding documentation on Xamarin Developer Center Uses Xamarin.Mac. This project covers working with...
+description: This project covers working with Data Binding and Key-Value Coding in a Xamarin.Mac application
 page_type: sample
 languages:
 - csharp
@@ -10,8 +10,19 @@ urlFragment: macdatabinding-storyboard
 ---
 # MacDatabinding Storyboard
 
-Source code for the [Data Binding and Key-Value Coding](/guides/mac/application_fundamentals/databinding/) documentation on [Xamarin Developer Center](http://docs.xamarin.com)
+Source code for the [Data Binding and Key-Value Coding](https://docs.microsoft.com/xamarin/mac/app-fundamentals/databinding) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin)
 
-Uses [Xamarin.Mac](http://xamarin.com).
+This project covers working with Data Binding and Key-Value Coding in a Xamarin.Mac application (using a `.storyboard` files) from simple control binding to Table View & Outlines and finally covers Collection Views (`NSCollectionView`).
 
-This project covers working with Data Binding and Key-Value Coding in a Xamarin.Mac application (using a `.storyboard` files) from simple control binding to Table View & Outlines and finally covers Collection Views (`NSCollectionView`).
+![Mac app using data binding](Screenshots/01.png)
+
+## Prerequisites
+
+* Mac computer with the latest version of macOS.
+* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
+* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple.
+
+## Running the sample
+
+1. Open the solution file (**.sln**) in Visual Studio for Mac.
+1. Use the **Run** button or menu to start the app.

MacInspector/Documentation/ReadMe.md

@@ -2,27 +2,27 @@
 
 Most modern OS X applications present auxiliary controls and options that affect the active document or selection as **Inspectors** that are part of the Main Window (like Apple's Pages or Numbers apps), instead of using [Panel Windows](https://developer.xamarin.com/guides/mac/user-interface/working-with-windows/#Panels).
 
-While **Panel Windows** have been deprecated in Storyboards, Apple does not provide a specific User Interface Widget to build **Inspectors**. Instead the developer must use `NSSplitViewControllers` and standard UI Widgets (such as Checkboxes and Text Fields) to create the [Inspector Interface](/guides/mac/user-interface/working-with-windows/#Inspectors).
+While **Panel Windows** have been deprecated in Storyboards, Apple does not provide a specific User Interface Widget to build **Inspectors**. Instead the developer must use `NSSplitViewControllers` and standard UI Widgets (such as Checkboxes and Text Fields) to create the [Inspector Interface](https://docs.microsoft.com/xamarin/mac/user-interface/window#inspectors).
 
-This app shows an example of creating two different types of Inspector Panels and running those panels with a Split View. It also uses a [Segment Control](/guides/mac/user-interface/standard-controls/#Working_with_Selection_Controls) in the [Toolbar](/guides/mac/user-interface/working-with-toolbars/) to control the **Inspector** similar to Apple's Pages word processing app.
+This app shows an example of creating two different types of Inspector Panels and running those panels with a Split View. It also uses a [Segment Control](https://docs.microsoft.com/xamarin/mac/user-interface/standard-controls#working-with-selection-controls) in the [Toolbar](https://docs.microsoft.com/xamarin/mac/user-interface/toolbar) to control the **Inspector** similar to Apple's Pages word processing app.
 
-# Implementation
+## Implementation
 
 The following sections will briefly discuss the key source code components and how they were used to implement MacInspector's functionality.
 
-## Generic Classes
+### Generic Classes
 
 The following generic classes are defined:
 
 * **CustomBox** - Provides a customized `NSBox` that responds to the user clicking on it and exposes its properties via [Key-Value Coding and Data Binding](https://developer.xamarin.com/guides/mac/application_fundamentals/databinding/).
 * **DocumentProperties.cs** - Provides a set of adjustable properties for the document being edited and exposes those properties via [Key-Value Coding and Data Binding](https://developer.xamarin.com/guides/mac/application_fundamentals/databinding/).
 * **ReplaceInspectorPanelSegue.cs** - Creates a custom Segue type that is used to show new **Inspector Panels** in the **Inspector**.
 
-## Resources
+### Resources
 
 Provides the custom Toolbar images used in MacInspector.
 
-## App, Windows and Controllers
+### App, Windows and Controllers
 
 The following classes provide app support, Windows, Windows Controllers, View and View Controller Support in the application:
 
@@ -32,12 +32,11 @@ The following classes provide app support, Windows, Windows Controllers, View an
 * **DocPrefsViewController.cs** - Handles the **Inspector Panel** for the `DocumentProperties` for the window. It uses [Key-Value Coding and Data Binding](https://developer.xamarin.com/guides/mac/application_fundamentals/databinding/) to maintain the values.
 * **Entitlements.plist** - Controls any Entitlements for the app such as Sandboxing or iCloud support.
 * **Info.plist** - The [`Info.plist`](https://developer.xamarin.com/guides/mac/getting_started/hello,_mac/#Info.plist) file defines information for the app such as its Title, Type and Icon.
-* **InspectorViewController.cs** - Handles the [Inspector Interface](/guides/mac/user-interface/working-with-windows/#Inspectors) and controls the hiding and displaying of **Inspector Panels**.
+* **InspectorViewController.cs** - Handles the [Inspector Interface](https://docs.microsoft.com/xamarin/mac/user-interface/window#Inspectors) and controls the hiding and displaying of **Inspector Panels**.
 * **Main.cs** - The [`Main.cs`](https://developer.xamarin.com/guides/mac/getting_started/hello,_mac/#Main.cs) file starts the App.
 * **Main.storyboard** - This [Storyboard](https://developer.xamarin.com/guides/mac/platform-features/storyboards/) defines the User Interface for the app. Use Xcode's Interface Builder to edit.
 * **MainSplitViewController.cs** - Handles the Split View used to contain the document content on the left and the **Inspector** on the right. Contains routines to help the Content communicate with the **Inspector**.
 * **MainWindow.cs** - Defines the main window for the app.
-* **MainWindowController.cs** - Handles the `MainWindow` for the app and controls the [Toolbar](/guides/mac/user-interface/working-with-toolbars/) for the window.
+* **MainWindowController.cs** - Handles the `MainWindow` for the app and controls the [Toolbar](https://docs.microsoft.com/xamarin/mac/user-interface/toolbar) for the window.
 
 For more detailed descriptions, please see the [API Documentation](html/index.html) for the MacInspector source code.
-

MacXibless/Readme.md

@@ -10,8 +10,19 @@ urlFragment: macxibless
 ---
 # MacXibless
 
-Source code for the [.XIBless User Interface Design](/guides/mac/application_fundamentals/xibless-ui) documentation on [Xamarin Developer Center](http://docs.xamarin.com)
+Source code for the [.XIBless User Interface Design](https://docs.microsoft.com/xamarin/mac/app-fundamentals/xibless-ui) documentation on [Xamarin Developer Center](http://docs.microsoft.com/xamarin).
 
-Uses [Xamarin.Mac](http://xamarin.com).
+This project covers creating a Xamarin.Mac Application's User Interface directly from C# code without using Xcode's Interface Builder or `.xib` files.
 
-This project covers creating a Xamarin.Mac Application's User Interface directly from C# code without using Xcode's Interface Builder or `.xib` files.
+![Mac app built without a XIB file](Screenshots/01.png)
+
+## Prerequisites
+
+* Mac computer with the latest version of macOS.
+* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
+* Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple.
+
+## Running the sample
+
+1. Open the solution file (**.sln**) in Visual Studio for Mac.
+1. Use the **Run** button or menu to start the app.