Updated YAML, intro, and bookmarks

Author: Linda-Editor

docs/sp-add-ins/design-sharepoint-add-ins.md

@@ -14,7 +14,8 @@ Let's say you have a killer idea for an add-in. In this section, we'll guide you
 
 Because the Cloud Add-in Model in SharePoint makes so many design options possible, SharePoint Add-ins can come in many shapes and sizes. This section contains helpful guidance for some of the most important decisions that you need to make as you are planning and designing the architecture and user experience of your add-in—including how you will host your add-in, how your add-in will efficiently and securely access data, and what the user experience will be.
 
-For an overview of the design and architecture options that are available with SharePoint Add-ins, see [Three ways to think about design options for SharePoint Add-ins](three-ways-to-think-about-design-options-for-sharepoint-add-ins.md). For an overview of what SharePoint Add-ins are, see [SharePoint Add-ins](sharepoint-add-ins.md).
+- For an overview of the design and architecture options that are available with SharePoint Add-ins, see [Three ways to think about design options for SharePoint Add-ins](three-ways-to-think-about-design-options-for-sharepoint-add-ins.md). 
+- For an overview of what SharePoint Add-ins are, see [SharePoint Add-ins](sharepoint-add-ins.md).
 
 <a name="SP15Design_Hostingmodel"> </a>
 ## Choose the right hosting model for your add-in
@@ -33,14 +34,14 @@ You must ensure that your add-in accesses data efficiently and securely. Various
 <a name="SP15Design_UX"> </a>
 ## Design the UX for your add-in
 
-As you design your add-in, your real goal should be to create an experience that enables users to complete the scenarios that you intend for them to accomplish. Discover the resources and design guidance that you need to build great add-ins that follow best practices for user experience design and have the familiar appearance and behavior of SharePoint in the following resource.
+As you design your add-in, your real goal should be to create an experience that enables users to complete the scenarios that you intend for them to accomplish. This topic will help you discover the resources and design guidance that you need to build great add-ins that follow best practices for user experience design and have the familiar appearance and behavior of SharePoint.
 
 [UX design for SharePoint Add-ins](ux-design-for-sharepoint-add-ins.md): Learn about the user experience options that you have when you build SharePoint Add-ins.
 
 <a name="Upgrade"> </a>
 ## Design with update in mind
 
-Someday you may want to produce an update of your add-in and upload it to the Office Store or an organization's add-in catalog. That task will be a lot easier if you think about how you would update the add-in while you are designing the first version. We recommend that you read the following articles early in the design phase: 
+Someday you may want to produce an update of your add-in and upload it to the Office Store or an organization's add-in catalog. That task will be a lot easier if you think about how you would update the add-in while you are designing the first version. We recommend that you read the following articles early in the design phase. 
 
 - [SharePoint Add-ins update process](sharepoint-add-ins-update-process.md)
 - [Update SharePoint Add-ins](update-sharepoint-add-ins.md)