First draft of TFVC walkthrough

Draft of a walkthrough for the Team Foundation Version Control preview extension.

Author: jmatthiesen

mac/tf-version-control.md

@@ -1,6 +1,6 @@
 ---
 title: "TF Version Control"
-description: "Using Azure functions in Visual Studio for Mac."
+description: "Connecting to Team Foundation Server or Visual Studio Team Services with Team Foundation version control."
 author: asb3993
 ms.author: amburns
 ms.date: 05/03/2018
@@ -9,83 +9,71 @@ ms.technology: vs-ide-install
 ms.assetid: 52D3D26A-4D01-4FD1-AAA1-AE7D7BD39746
 ---
 
-# Visual Studio for macOS TFS Add-in
+# Connecting to Team Fondation version control 
 
-This article introduces the Visual Studio for Mac add-in for interacting with Microsoft Team Foundation Server and Visual Studio Team Services.
+Visual Studio Team Services (VSTS) and Team Foundation Server (TFS) provide two models of version control: Git, which is distributed version control, and Team Foundation Version Control (TFVC), which is centralized version control. This article provides an overview and a starting point for using Team Foundation Version Control with Visual Studio for Mac.
+
+> [!NOTE]
+> **Note**: Team Foundation Version Control support is currently in preview and some functionality is not yet fully working. More changes still to come!
 
 ## Requirements
 
-This add-in works on Visual Studio for Mac version 7.5 and above
+* Visual Studio for Mac version 7.5 or later.
+* A Project in Visual Studio Team Services or Team Foundation Server, configured to use Team Foundation Version Control.
 
 ## Installation
 
-[Jordan: can you add information here?]
+From within Visual Studio for Mac, choose the **Visual Studio > Extensions...** menu. Search for "TF version control" and install the **Team Foundation Version Control** extension. Restart the IDE when prompted.
 
 ## Using the add-in
 
-In Menu > Version Control section you will find the Team Foundation Server menu at the bottom. To start click on Connect to Server. 
+Once the extension is installed, select the **Version Control > Team Foundation Version Control > Connect to Team Foundation Version Control...** menu. 
 
 <img src="images/add-remove-server.png" alt="Connect with a TFS Server" Width="600" />
 
-Choose between VSTS or TFVC server:
+Choose either Visual Studio Team Services or Team Foundation Server to get started:
 
 <img src="images/choose-server-type.png" alt="Connect with a TFS Server" Width="600" />
 
 Enter you credentials: 
 
 <img src="images/login.png" alt="Connect with a TFS Server" Width="600" />
 
-The following authentication modes are supported:
-- OAuth
-- Basic
-- Ntlm
-
-Choose the projects thsat you want to be connected to: 
+Then, choose the projects that you want to access: 
 
 <img src="images/choose-projects.png" alt="Choose projects" Width="500" />
 
-To continue, open **Team Explorer** from **Menu > Version Control > Team Foundation Server > Team Explorer**. 
-
-<img src="images/teamexplorerpad.png" alt="Team Explorer" Width="300" />
-
-Frome here, you can access:
-- SourceControlExplorer
-- WorkItems
+To continue, close the dialogs and then use the **Version Control > Team Foundation Version Control > Source Control Explorer** menu to browse source.
 
-Double click on Source Control option to open SourceControlExplorerView. 
+> [!WARNING]
+> **Known issue**: In this preview release, the first time you open source controle explorer, you'll have to create a new workspace.
 
 <img src="images/sourceexplorer.png" alt="Source Explorer" Width="800" />
 
-Team Foundation Version Control (TFVC) is a centralized version control system. TFVC lets you do:
+From the Source Code Explorer, you can browse your source code on the server and perform a variety of actions :
 - Manage Workspaces (Create, edit or delete).
 - Navigate between project structure.
 - Map projects.
 - Get projects.
-- Lock & Unlock.
-- Rename.
-- Delete.
+- Lock & Unlock files.
+- Rename files.
+- Delete files.
 - Add new file.
-- CheckOut.
-- CheckIn.
+- Check out.
+- Check in.
 - View history changes.
 - Compare changes.
 
-From "Manage" button we can create a manage workspaces. 
+## Creating a new workspace
+In the Source Control Explorer, click on the **Manage Workspaces** button. 
 
 <img src="images/manage-workspaces.png" alt="Manage Workspaces" Width="600" />
 
-And create a new one:
+Click on **Add** to create a new workspace.
 
 <img src="images/create-workspace.png" alt="Create Workspace" Width="400" />
 
-After creating a workspace, the actions are available in a contextual menu.
-
-<img src="images/sourceexplorer-menu.png" alt="Create Workspace" Width="600" />
-
-To work witk WorkItems, double click in WorkItems to open WorkItemsView.
-
-<img src="images/workitems.png" alt="Create Workspace" Width="600" />
+Provide a name for the workspace and then click **Add Working Folder** to map the project to a local folder on your computer.
 
-The WorkItems actions are available in a contextual menu.
+When done, click OK, then close the Manage Workspaces dialog. Now, you're ready to get files though the Source Code Explorer and get started.
 
-<img src="images/workitems-menu.png" alt="Create Workspace" Width="600" />