Add files via upload

Author: ajford76

docs/design/key-web-part-examples.md

@@ -0,0 +1,31 @@
+---
+title: Key web part examples
+ms.date: 5/08/2018 
+---
+
+# Key web part examples
+
+Web parts are the building blocks of your page. 
+
+This is a visual overview of Communication site and Team site templates, highlighting how web parts work together to create a coherent overall design. Use these pages as reference when designing a SharePoint web part. It is important to consider how the web part will look and function when sitting next to other web parts on a page. Follow the patterns in this documentation and on the [Office UI Fabric site](https://developer.microsoft.com/en-us/fabric) to ensure consistency in layout and grid alignment, font size and hierarchy, commanding, empty states and more.
+
+
+# Communication sites
+
+The Topic design is used when you have a lot of information to share, such as news, events, report and other content. It is built from the Hero, News, Events, Highlighted content, Quick links and People web parts.
+
+![Topic site homepage](../images/sites_topic.png) 
+
+
+The Showcase design is used to feature a product, team or event. It is leverages the Hero and Image gallery web parts to show rich visual content.
+
+
+![Showcase site homepage](../images/sites_showcase.png) 
+
+# Team sites
+
+The Team site design is the default layout for any new team. It features the News, Quick links, Highlighted content and Document library web parts.
+![Team site homepage](../images/sites_teamsite.png) 
+
+These example site and web part designs have been added to the SharePoint toolkit and can be used as reference when designing web parts.
+[SharePoint toolkit](https://developer.microsoft.com/en-us/fabric#/resources)