update readmes, fix links

conceptdev · conceptdev · commit f6a2fa928291 · 2019-07-23T12:04:22.000-07:00
diff --git a/FileSystemSampleCode/README.md b/FileSystemSampleCode/README.md
@@ -10,10 +10,25 @@ urlFragment: filesystemsamplecode
 ---
 # File System
 
-This sample application demonstrates how to use the file system in iOS
+This sample application demonstrates how to use the file system in iOS, discussed in the [Xamarin.iOS documentation](https://docs.microsoft.com/xamarin/ios/app-fundamentals/file-system).
 
 Working with the file system in iOS is not unlike working with the file system in .NET from Windows.
 You can still use the System.IO classes that you're used to working with but there
 are a few restrictions to be aware of.
 Additionally, it’s important to understand the directory structure specific to iOS
 applications in order to know where and when to store things.
+
+![iOS app that loads and saves to the file system](Screenshots/FileSystem01.png)
+
+## Prerequisites
+
+- [Visual Studio](https://visualstudio.microsoft.com/) on Mac or Windows.
+  - _Mobile Development with .NET (Xamarin)_ workload installed.
+  - If you're using Windows, there should be a Mac available on the network.
+  - Mac computer with the latest version of macOS.
+- Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple on the Mac.
+
+## 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.
diff --git a/FontList/README.md b/FontList/README.md
@@ -14,10 +14,19 @@ Lists the fonts available on the device and shows a preview of each font.
 
 ![Main Screen](Screenshots/screenshot-1.png)
 
-## License
+## Prerequisites
 
-Code is released under the MIT license
+- [Visual Studio](https://visualstudio.microsoft.com/) on Mac or Windows.
+  - _Mobile Development with .NET (Xamarin)_ workload installed.
+  - If you're using Windows, there should be a Mac available on the network.
+  - Mac computer with the latest version of macOS.
+- Latest version of [Xcode](https://developer.apple.com/xcode/) from Apple on the Mac.
+
+## Running the sample
 
-## Authors
+1. Open the solution file (**.sln**) in Visual Studio for Mac.
+1. Use the **Run** button or menu to start the app.
 
-Bryan Costanich
+## License
+
+Code is released under the MIT license
diff --git a/GLCameraRipple/README.md b/GLCameraRipple/README.md
@@ -12,14 +12,12 @@ urlFragment: glcameraripple
 
 This sample shows how to use GLKit to render OpenGL frames, AVFoundation to fetch live video from the camera and OpenTK's API to load a couple of shaders that simulate a water ripple effect when the user touches the display.
 
+![Screenshot of ripple effect](Screenshots/GLCameraRipple.PNG)
+
 ## Related Links
 
 - [Original sample](http://developer.apple.com/library/ios/#samplecode/GLCameraRipple/Introduction/Intro.html)
 
 ## License
 
 Xamarin port changes are released under the MIT license.
-
-## Author
-
-Ported to Xamarin.iOS by Miguel de Icaza
diff --git a/GLPaint-GameView/README.md b/GLPaint-GameView/README.md
@@ -16,8 +16,4 @@ to create a touch painting application.
 Loosely based on Apple's GLPaint example:
 http://developer.apple.com/library/ios/#samplecode/GLPaint/Introduction/Intro.html
 
-**NOTE: This sample will only work with Xcode 5.0 or above.
-
-## Authors
-
-Miguel de Icaza
+![Screenshot of paint app](Screensnots/GLPaint-GameView.PNG)
diff --git a/GraphicsAndAnimation/README.md b/GraphicsAndAnimation/README.md
@@ -11,3 +11,5 @@ urlFragment: graphicsandanimation
 # Graphics and Animations
 
 This contains three samples demonstrating the use of Core Graphics and Core Animation in iOS. It accompanies the [Graphics and Animation in iOS](https://docs.microsoft.com/xamarin/ios/platform/graphics-animation-ios/) guides.
+
+![Screenshot of image effects](Screenshots/07_animated_transition.png)
diff --git a/GrowRowTable/README.md b/GrowRowTable/README.md
@@ -14,6 +14,4 @@ Starting with iOS 8, Apple added the ability to create a Table View (`UITableVie
 
 This sample shows how to create a Table View with Auto-Resizing Row Height.
 
-# Author
-
-Kevin Mullins - For Documentation usage.
+![App with variable height rows](Screenshots/01.png)
diff --git a/HelloWorld_iPhone/README.md b/HelloWorld_iPhone/README.md
@@ -12,3 +12,5 @@ urlFragment: helloworld-iphone
 
 A simple hello world sample demonstrating the use of the UIButton
 and UILabel controls, and simple user interaction with them.
+
+![Simple apps with buttons and text](Screenshots/HelloWorldiPhone01.png)
diff --git a/Hello_ComplexUniversal/README.md b/Hello_ComplexUniversal/README.md
@@ -1,6 +1,6 @@
 ---
 name: Xamarin.iOS - Hello, Complex Universal
-description: A sample demonstrating how to create universal applications that will run on both iPhone and iPad devices, by switching the UI based on the...
+description: "A sample demonstrating how to create universal applications that will run on both iPhone and iPad devices #getstarted"
 page_type: sample
 languages:
 - csharp
@@ -19,4 +19,4 @@ way UI switching is done. Instead of having one controller manage
 two separate views depending on the device in use, we employ two
 different root controllers.
 
-**NOTE: This sample will only work with Xcode 5.0 or above.
+![Simple app with button and text](Screenshots/HelloComplexUniverse02.png)
diff --git a/Hello_MultiScreen_iPhone/README.md b/Hello_MultiScreen_iPhone/README.md
@@ -10,9 +10,11 @@ urlFragment: hello-multiscreen-iphone
 ---
 # Hello Multi-Screen iPhone
 
-[Xamarin.iOS samples](https://review.docs.microsoft.com/en-us/samples/browse/?branch=master&products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
+[Xamarin.iOS samples](https://docs.microsoft.com/en-us/samples/browse/?products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
 
 This sample serves as an introduction to the primary pattern used
 in iOS for user interfaces: MVC (Model-View-Controller). It shows
 how to use the UINavigationController class to manage the user
 interface of a multi-screen application.
+
+![App with text hello world](Screenshots/HelloMultiscreen02.png)
diff --git a/Hello_Universal/README.md b/Hello_Universal/README.md
@@ -10,8 +10,10 @@ urlFragment: hello-universal
 ---
 # Hello, Universal App
 
-[Xamarin.iOS samples](https://review.docs.microsoft.com/en-us/samples/browse/?branch=master&products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
+[Xamarin.iOS samples](https://docs.microsoft.com/en-us/samples/browse/?products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
 
 A sample demonstrating how to create universal applications that
 will run on both iPhone and iPad devices, by switching the UI based
 on the `UIInterfaceIdiom` enum.
+
+![Simple iPhone app](Screenshots/Hello_Universal1.png)
diff --git a/Hello_iOS/README.md b/Hello_iOS/README.md
@@ -10,12 +10,10 @@ urlFragment: hello-ios
 ---
 # Hello, iOS
 
-[Xamarin.iOS samples](https://review.docs.microsoft.com/en-us/samples/browse/?branch=master&products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
+[Xamarin.iOS samples](https://docs.microsoft.com/samples/browse/?products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
 
 This sample is the application that will be built at the end of the [iOS Get Started](https://docs.microsoft.com/xamarin/ios/get-started/hello-ios/) guides.
 
 There are two seperate folders containing a solution. **Hello.iOS** is the single view application that will be producted at the end of the [Hello, iOS Quickstart](https://docs.microsoft.com/xamarin/ios/get-started/hello-ios/hello-ios-quickstart), and **Hello.iOS_MultiScreen** is the two screen application produced at the end of the [Hello, iOS Multiscreen Quickstart](https://docs.microsoft.com/xamarin/ios/get-started/hello-ios-multiscreen/).
 
-# Author
-
-Amy Burns
+![Phoneword running on iPhone simulator](Screenshots/image1.png)
diff --git a/Hello_iPad/README.md b/Hello_iPad/README.md
@@ -10,7 +10,7 @@ urlFragment: hello-ipad
 ---
 # Hello iPad
 
-[Xamarin.iOS samples](https://review.docs.microsoft.com/en-us/samples/browse/?branch=master&products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
+[Xamarin.iOS samples](https://docs.microsoft.com/samples/browse/?products=xamarin&term=Xamarin.iOS) | [Xamarin.iOS docs](https://docs.microsoft.com/xamarin/ios/)
 
 This is a simple hello world application demonstrating how to
 create, configure, and build applications specific to the iPad.
diff --git a/HomeKit/HomeKitIntro/README.md b/HomeKit/HomeKitIntro/README.md
@@ -44,7 +44,7 @@ Do the following to enable HomeKit support:
 24. Scroll to the bottom of the list and place a check by the **Enable HomeKit** checkbox.
 25. Save the changes to the entitlements.
 
-##The HomeKit Accessory Simulator
+## The HomeKit Accessory Simulator
 
 To make testing of a HomeKit enable mobile applications possible, Apple has created a HomeKit Accessory Simulator that allows the developer to create and configure different types of simulated home automation accessories. Using the simulator, the developer can create a wide range of virtual hardware with different configurations of options and features.  Apple is providing the HomeKit Accessory Simulator as a separate download from Xcode 6.
 
@@ -56,7 +56,7 @@ To install the simulator, do the following:
 4. Open the Downloads folder and unzip the tool.
 5. Copy the contents of the zip file to the Applications folder.
 
-###Creating Virtual Accessories
+### Creating Virtual Accessories
 
 To start the HomeKit Accessory Simulator and create a few virtual accessories, do the following;
 
@@ -69,16 +69,15 @@ To start the HomeKit Accessory Simulator and create a few virtual accessories, d
 
 With some sample virtual HomeKit accessories created and configured, a Xamarin iOS 8 mobile application can be created to consume and control these accessories.
 
-##Testing a HomeKit App
+## Testing a HomeKit App
 
 When the application is first run, the user will be asked if they want to allow it to access their HomeKit information. If the user answers **OK**, then the application will be able to work with their HomeKit Accessories otherwise it will not and any calls to HomeKit will fail with an error. 
 
 A Primary Home must be created and configured before any other function of the HomeKit framework is available to an iOS 8 mobile application. It is also the responsibility of the application to provide a way for the user to create and assign a Primary Home if one does not already exist. After the application first starts or when it has returned to focus after being in the background, it should monitor the `DidUpdateHomes` event of the `HMHomeManager` and check for the existence of the Primary Home. If one does not exist, it should provide an interface for the user to create one.
 
 Once a Primary Home has been created or accessed, the iOS 8 application can call the `MHAccessoryBrowser` to find any new home automation accessories and add them to a home. Once the new accessory has been found, it should be presented to the user and they should be allowed to select an accessory and add it to a home. When the user selects an accessory from the list, the application calls the Home’s `AddAccessory` method to add it to the Home’s collection of accessories. The user will be asked to enter the setup code for the device to add, In the HomeKit Accessory Simulator this number can be found under the **Accessories Name**. For a real HomeKit accessory, the setup code will either be presented in the accessory’s user manual, on the product box or on a label on the device itself.
 
-## When working with HomeKit Service Characteristics and simulated accessories, modifications to Characteristics values can be monitored inside the HomeKit Accessory Simulator. With the `HomeKitIntro` app running on real iOS Device Hardware, changes to a characteristic’s value should be seen nearly instantly in the HomeKit Accessory Simulator. 
-## **NOTE:** Testing HomeKit only works on a real iOS 8 Hardware Device and not in the iOS 8 Simulator.
-
-
+When working with HomeKit Service Characteristics and simulated accessories, modifications to Characteristics values can be monitored inside the HomeKit Accessory Simulator. With the `HomeKitIntro` app running on real iOS Device Hardware, changes to a characteristic’s value should be seen nearly instantly in the HomeKit Accessory Simulator.
 
+> [!NOTE]
+> Testing HomeKit only works on a real iOS 8 Hardware Device and not in the iOS 8 Simulator.
diff --git a/Keychain/README.md b/Keychain/README.md
@@ -1,20 +1,16 @@
 ---
 name: Xamarin.iOS - Keychain
-description: An example on using Apple's keychain storage for storing information securely within an application.
+description: An example using Apple's keychain storage for storing information securely within an application.
 page_type: sample
 languages:
 - csharp
 products:
 - xamarin
 urlFragment: keychain
 ---
-# Keychain
+# Keychain on Xamarin.iOS
 
-An example on using Apple's keychain storage for storing
+An example using Apple's keychain storage for storing
 information securely within an application.
 
 ![Keychain application screenshot](Screenshots/Keychain.png "Keychain application screenshot")
-
-## Authors
-
-Miguel de Icaza
diff --git a/LazyTableImages/README.md b/LazyTableImages/README.md
@@ -11,3 +11,5 @@ urlFragment: lazytableimages
 # Lazy Table Images
 
 This sample demonstrates how to lazily download images and add them to a prepopulated table.
+
+![iOS app with images in a table](Screenshots/LazyTableImages.png)
diff --git a/LazyTableImagesAsync/README.md b/LazyTableImagesAsync/README.md
@@ -1,6 +1,6 @@
 ---
 name: Xamarin.iOS - Lazy Table Images Async
-description: This sample demonstrates how to lazily download images and add them to a prepopulated table new Async/Await feature which is available in...
+description: This sample demonstrates how to lazily download images and add them to a prepopulated table new async/await feature which is available in...
 page_type: sample
 languages:
 - csharp
@@ -10,4 +10,6 @@ urlFragment: lazytableimagesasync
 ---
 # Lazy Table Images Async
 
-This sample demonstrates how to lazily download images and add them to a prepopulated table new Async/Await feature which is available in Xamarin.iOS 6.4.
+This sample demonstrates how to lazily download images and add them to a prepopulated table new `async`/`await` feature which is available in Xamarin.iOS 6.4.
+
+![iOS app with images in a table](Screenshots/LazyTableImages.png)
diff --git a/LifecycleDemo/README.md b/LifecycleDemo/README.md
@@ -10,5 +10,6 @@ urlFragment: lifecycledemo
 ---
 # LifeCycle Demo
 
-This basic sample relates to the [iOS Backgrounding](http://developer.xamarin.com/guides/ios/application_fundamentals/backgrounding/) guides in the developers centre. It adds location to the `AppDelegate` to display when an application is entering a given state. You can find out more information about this by visiting the [Part 2- Application Lifecycle Demo](/guides/ios/application_fundamentals/backgrounding/part_2_application_lifecycle_demo/) guide.
+This basic sample relates to the [iOS Backgrounding](https://docs.microsoft.com/xamarin/ios/app-fundamentals/backgrounding/) guides in the developers centre. It adds location to the `AppDelegate` to display when an application is entering a given state. You can find out more information about this by visiting the [Part 2- Application Lifecycle Demo](https://docs.microsoft.com/xamarin/ios/app-fundamentals/backgrounding/application-lifecycle-demo) guide.
 
+![App output window showing lifecycle events](Screenshots/image4.png)
diff --git a/LineLayout/README.md b/LineLayout/README.md
@@ -12,11 +12,10 @@ urlFragment: linelayout
 
 This is a port of the WWDC2012 sample
 
-This example shows how to implement a document-browser-like-interface 
+This example shows how to implement a document-browser-like-interface
 as a flow layout subclass, and using automatic invalidation on bounds
 change to implement the 'scale center cell' effect. It also implements
-a layout-level method to adjust the scrolling final position so the 
+a layout-level method to adjust the scrolling final position so the
 final cell will always be centered.
 
-Ported By: GouriKumari
-
+![iPad app showing layout example](Screenshots/LineLayout.png)
diff --git a/LocalNotifications/README.md b/LocalNotifications/README.md
@@ -13,5 +13,6 @@ urlFragment: localnotifications
 This sample illustrates how to schedule and respond to
 local notifications.
 
-It related to the Local Notifications [guide](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/notifications/ios/local_notifications_in_ios/) and [Walkthrough](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/notifications/ios/local_notifications_in_ios_walkthrough/)
+It related to the [Local Notifications doc](https://docs.microsoft.com/xamarin/ios/platform/user-notifications/deprecated/local-notifications-in-ios) and [walkthrough](https://docs.microsoft.com/xamarin/ios/platform/user-notifications/deprecated/local-notifications-in-ios-walkthrough)
 
+![iOS app showing a notification](Screenshots/screenshot-2.png)
diff --git a/Location/README.md b/Location/README.md
@@ -8,8 +8,10 @@ products:
 - xamarin
 urlFragment: location
 ---
-# Location
- This is an iOS Location application that prints information about our current location: latitude, longitude, and other parameters to the screen. This application will demonstrate how to properly perform location updates while the application is either Active or Backgrounded.
- 
-It relates to the [Location Walkthrough](/guides/ios/application_fundamentals/backgrounding/part_4_ios_backgrounding_walkthroughs/location_walkthrough/) guide in the developer centre.
+# Location in Xamarin.iOS
 
+This is an iOS Location application that prints information about our current location: latitude, longitude, and other parameters to the screen. This application will demonstrate how to properly perform location updates while the application is either Active or Backgrounded.
+
+It relates to the [location walkthrough doc](https://docs.microsoft.com/xamarin/ios/app-fundamentals/backgrounding/ios-backgrounding-walkthroughs/location-walkthrough) in the developer centre.
+
+![iOS app showing location data](Screenshots/image5.png)
diff --git a/LowLevelGLPaint/README.md b/LowLevelGLPaint/README.md
@@ -1,6 +1,6 @@
 ---
 name: Xamarin.iOS - Low-Level OpenGL Painting
-description: An example on using the low-level OpenGL classes to create a touch painting application. Loosely based on Apple's GLPaint example:...
+description: An example on using the low-level OpenGL classes to create a touch painting application. Loosely based on Apple's GLPaint example...
 page_type: sample
 languages:
 - csharp
@@ -16,10 +16,4 @@ to create a touch painting application.
 Loosely based on Apple's GLPaint example:
 http://developer.apple.com/library/ios/#samplecode/GLPaint/Introduction/Intro.html
 
-## Preview
-
-![iPhone running GLPaint sample](http://farm7.static.flickr.com/6143/5999004778_b2801d14e2.jpg)
-
-## Authors
-
-Miguel de Icaza
+![iPhone running GLPaint sample](Screenshots/Low-LevelGLPaint.png)
diff --git a/ManualCameraControls/README.md b/ManualCameraControls/README.md
@@ -10,5 +10,6 @@ urlFragment: manualcameracontrols
 ---
 # Manual Camera Controls
 
-The AVFoundation Framework makes it easier than ever for users to take great photos by allowing for Manual Camera Controls. Using this framework, an application can take direct control over the camera focus, white balance, and exposure settings. An application can also use bracketed exposure captures to automatically capture images with different exposure settings. This sample related to the [Introduction to Manual Camera Controls](http://developer.xamarin.com/guides/ios/platform_features/intro_to_manual_camera_controls/) guide in the developers centre.
+The AVFoundation Framework makes it easier than ever for users to take great photos by allowing for Manual Camera Controls. Using this framework, an application can take direct control over the camera focus, white balance, and exposure settings. An application can also use bracketed exposure captures to automatically capture images with different exposure settings. This sample related to the [Introduction to Manual Camera Controls](https://docs.microsoft.com/xamarin/ios/user-interface/controls/intro-to-manual-camera-controls) guide in the developers centre.
 
+![App showing a monkey picture with camera controls](Screenshots/image14.png)
diff --git a/ManualStoryboard/README.md b/ManualStoryboard/README.md
@@ -10,8 +10,8 @@ urlFragment: manualstoryboard
 ---
 # Manual Storyboard
 
-How to instantiate Storyboards programatically. This is the finished application from the [Instantiate Storyboards Manually](http://docs.xamarin.com/guides/ios/user_interface/introduction_to_storyboards/#Instantiate_Storyboards_Manually) section of the Introduction to Storyboards document.
+How to instantiate Storyboards programatically. This is the finished application from the [Instantiate Storyboards Manually](https://docs.microsoft.com/xamarin/ios/user-interface/storyboards/?tabs=macos#Instantiate_Storyboards_Manually) section of the Introduction to Storyboards document.
 
 It also includes a sample detailing how to create conditional segues.
 
-
+![App with pink background](Screenshots/pvc.png)
diff --git a/MapCallouts/README.md b/MapCallouts/README.md
diff --git a/MapDemo/README.md b/MapDemo/README.md
diff --git a/MapKitSearch/README.md b/MapKitSearch/README.md
diff --git a/MapsWalkthrough/README.md b/MapsWalkthrough/README.md
diff --git a/intro-to-extensions/README.md b/intro-to-extensions/README.md
