Merge remote-tracking branch 'refs/remotes/SharePoint/master'

Author: Lauragra

.github/CONTRIBUTING.md

@@ -105,14 +105,14 @@ remove: Total 10 (delta 1), reused 10 (delta 1)
 Unpacking objects: 100% (10/10), done.
 ```
 
-## Switch to `staging` branch
+## Switch to `master` branch
 
-In order to add your changes, you will need to do those in the `staging` branch.
+In order to add your changes, you will need to do those in the `master` branch.
 
-Type the following command in the console to switch to `staging` branch:
+Type the following command in the console to switch to `master` branch:
 
 ```
-git checkout staging
+git checkout master
 ```
 
 Now, you can update existing docs or add new docs to the docs repo.
@@ -130,13 +130,13 @@ Depending on the doc's intent, you can choose to add your doc into  `basics` or
 
 Once you have completed adding your changes, you can submit a pull request. 
 
-Navigate to the forked sp-dev-docs repo in your account. Make sure your current branch is `staging` branch.
+Navigate to the forked sp-dev-docs repo in your account. Make sure your current branch is `master` branch.
 
-Once you are in the staging branch, you should see a message to `Compare & pull request`
+Once you are in the `master` branch, you should see a message to `Compare & pull request`
 
 ![Submit a pull request to sp-dev-docs repo](../images/contribute-docs-submit-pr.png)
 
-This will start a new pull request. Make sure you use the following [template]() to fill in your changes. Make sure you are creating this pull request against the `staging` branch.
+This will start a new pull request. Make sure you use the following [template]() to fill in your changes. Make sure you are creating this pull request against the `master` branch.
 
 Once you have all the information, click the `Create pull request` to submit your pull request.
 

.github/PULL_REQUEST_TEMPLATE.md

@@ -12,4 +12,4 @@ Please describe the changes in this PR. Sample description or details around bug
 #### Guidance
 *You can delete this section when you are submitting the pull request.* 
 * *Please update this PR information accordingly. We'll use this as part of our release notes in monthly communications.*
-* *Please target your PR to 'staging' branch.*
+* *Please target your PR to 'master' branch. Released documents are in live branch.*

.openpublishing.publish.config.json

@@ -22,11 +22,14 @@
       }
     }
   ],
-  "notification_subscribers": [],
+  "notification_subscribers": [
+    "[email protected]"
+  ],
   "branches_to_filter": [],
   "skip_source_output_uploading": false,
   "need_preview_pull_request": false,
   "contribution_branch_mappings": {},
+  "git_repository_branch_open_to_public_contributors": "master",
   "dependent_repositories": [
     {
       "path_to_root": "_themes",

README.md

@@ -2,14 +2,17 @@
 
 The SharePoint Framework (SPFx) is a page and part model that enables client-side development for building SharePoint experiences. It facilitates easy integration with the SharePoint data, and provides support for open source tooling development.
 
-* [Official SharePoint Framework Documentation](http://dev.office.com/sharepoint/docs/spfx/sharepoint-framework-overview)
+* [Official SharePoint Framework Documentation](http://aka.ms/spfx)
 
-This repository contains the raw documents published to dev.office.com site. Feel free to use [Issues]((https://github.com/SharePoint/sp-dev-docs/issues)) list to report us findings or also submit pull requests around the existing documentation. 
+This repository contains the raw documents published to docs.microsoft.com site. Feel free to use [Issues]((https://github.com/SharePoint/sp-dev-docs/issues)) list to report us findings or also submit pull requests around the existing documentation. 
 
 The SharePoint Framework now generally available. Please check more release details either from the [GA release notes](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes-GA) or from the [Office Blog post](https://blogs.office.com/2017/02/23/sharepoint-framework-reaches-general-availability-build-and-deploy-engaging-web-parts-today/) around the GA release. If you find issues or have new ideas and suggestions for SharePoint Framework, make sure you submit them [here](https://github.com/SharePoint/sp-dev-docs/issues). We’ll also be monitoring [#spfx](http://sharepoint.stackexchange.com/tags/spfx/), [#spfx-webparts](http://sharepoint.stackexchange.com/tags/spfx-webparts/), and [#spfx-tooling](http://sharepoint.stackexchange.com/tags/spfx-tooling/) at [SharePoint StackExchange](http://sharepoint.stackexchange.com/) as well.
 
 ## SharePoint Framework Releases
 
+* **September 25, 2017**
+   *  **GA of Extensions and SPFx v1.3**.
+
 * **June 6, 2017**
    *  **Dev Preview of extensions is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes---Extensions-Dev-Preview-Drop-1)
 
@@ -19,29 +22,14 @@ The SharePoint Framework now generally available. Please check more release deta
 * **Jan 9, 2017**
    *  **RC0 is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes-RC0)
 
-* **Nov 22, 2016**
-   *  **Drop 6 is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes-Drop-6)
-
-* **Oct 17, 2016**
-   *  **Drop 5 is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes-Drop-5)
-
-* **Sept 21, 2016**
-   *  **Drop 4 is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes-Drop-4-and-MDL2)
-
-* **Sep 14, 2016**
-   *  **Drop 3 is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes-Drop-3)
-   
-* **Sep 1, 2016**
-   * **Drop 2 is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Release-Notes-Drop-2)
-
 * **Aug 17, 2016**
    * **Drop 1 is available**.  [See the release notes here](https://github.com/SharePoint/sp-dev-docs/wiki/Drop-1)
 
 ## Get Started
 
-* [Setup your Office 365 Developer Tenant](http://dev.office.com/sharepoint/docs/spfx/set-up-your-developer-tenant)
-* [Setup your Machine](http://dev.office.com/sharepoint/docs/spfx/set-up-your-development-environment)
-* [Go build your first web part](http://dev.office.com/sharepoint/docs/spfx/web-parts/get-started/build-a-hello-world-web-part)
+* [Setup your Office 365 Developer Tenant](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/set-up-your-developer-tenant)
+* [Setup your Machine](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/set-up-your-development-environment)
+* [Go build your first web part](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/web-parts/get-started/build-a-hello-world-web-part)
 
 ## Reference
 * [sp-component-base](reference/spfx/sp-component-base-module.md)
@@ -54,15 +42,15 @@ The SharePoint Framework now generally available. Please check more release deta
 
 ## Learn More
 
-* [Background and Philosophy](http://dev.office.com/sharepoint/docs/spfx/sharepoint-framework-overview)
-* [Design Great Web Parts](http://dev.office.com/sharepoint/docs/spfx/web-parts/basics/design-considerations-for-web-parts)
-* [API Docs](https://sharepoint.github.io/)
+* [Background and Philosophy](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/sharepoint-framework-overview)
+* [Design Great Web Parts](https://docs.microsoft.com/en-us/sharepoint/dev/design/design-guidance-overview)
+* [API Docs](https://docs.microsoft.com/en-us/javascript/api/sp-application-base)
 
 ## Updates & Feedback
 
 To keep track of improvements to the Office 365 Framework, please take a look at:
 
-* [@SharePoint](https://twitter.com/sharepoint) and [@OfficeDev](https://twitter.com/officedev) on Twitter
+* [@SharePoint](https://twitter.com/sharepoint), [@OfficeDev](https://twitter.com/officedev) and [@OfficeDevPnP](https://twitter.com/officedevpnp) on Twitter
 * [Office Developer Blog](http://dev.office.com/blogs)
 
 Provide Feedback:

docs/apis/communication-site-creation-rest.md

@@ -2,6 +2,9 @@
 
 Learn how to create and get the status of a new modern SharePoint Communication site with the REST interface.
 
+> [!NOTE]
+> There is a known bug with this API which is blocking completely this behavior. Fix will be rolling gradually to SharePoint Online by end of October 2017.
+
 ## Prerequisites
 
 This topic assumes that you are already familiar with the topics Get to know the SharePoint REST service and Complete basic operations using SharePoint REST endpoints. It does not provide code snippets.
@@ -23,14 +26,18 @@ url: /_api/sitepages/communicationsite/create
 method: POST
 body:
 {
-  "__metadata":{"type":"SP.Publishing.CommunicationSiteCreationRequest"},
-  "AllowFileSharingForGuestUsers":false,
-  "Classification":"Contoso confidential",
-  "Description":"Here is my communication site",
-  "SiteDesignId":"6142d2a0-63a5-4ba0-aede-d9fefca2c767",
-  "Title":"comm1",
-  "Url":"https://contoso.sharepoint.com/sites/comm1",
-  "lcid":1033
+   "request":{
+      "__metadata":{
+         "type":"SP.Publishing.CommunicationSiteCreationRequest"
+      },
+      "AllowFileSharingForGuestUsers":false,
+      "Classification":"LBI",
+      "Description":"Description",
+      "SiteDesignId":"6142d2a0-63a5-4ba0-aede-d9fefca2c767",
+      "Title":"Comm Site 1",
+      "Url":"https://vesku.sharepoint.com/sites/commsite132",
+      "lcid":1033
+   }
 }
 ```
 

docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md

@@ -7,10 +7,7 @@ Before you get started, make sure that you're familiar with the following:
 - [Using the Client Object Model](https://msdn.microsoft.com/en-us/library/ff798388.aspx)
 - [Common Programming Tasks in the Managed Client Object Model](https://msdn.microsoft.com/en-us/library/ee537013.aspx)
 
-Install the following components for CSOM development:
-
-* [SharePoint Server 2016 Client Component SDK](https://www.microsoft.com/en-us/download/details.aspx?id=51679)
-* [Microsoft.SharePointOnline.CSOM](https://www.nuget.org/packages/Microsoft.SharePointOnline.CSOM/) NuGet package (version 16.1.6906.1200 or later)
+You will also need to install the [Microsoft.SharePointOnline.CSOM](https://www.nuget.org/packages/Microsoft.SharePointOnline.CSOM/) NuGet package (version 16.1.6906.1200 or later).
 
 ## CSOM code example
 
@@ -107,7 +104,7 @@ __Parameters:__ string name<br/>
 __Return type:__ ThemeProperties
 
 ### HideDefaultThemes public property
-This property indicates whether the default themes are hidden in the theme picker UI for modern pages. You might want to set this property to __true__ after you define custom themes, to allow only specific themes to be used.
+This property indicates whether the default themes are available in the theme picker UI. The default setting is __false__ (the default themes are available), but you might want to set this property to __true__ after you define custom themes, to allow only specific themes to be used.
 
 __Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
 __Type:__ Boolean
@@ -165,7 +162,7 @@ __Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
 __Parameters:__ string name, string themeJson<br/>
 __Return type:__ ClientResult<bool>
 
-## Additional resources
+## See also
 
 * [SharePoint site theming overview](sharepoint-site-theming-overview.md)
 * [SharePoint site theming: JSON schema](sharepoint-site-theming-json-schema.md)

docs/design/grid-and-responsive-design.md

@@ -85,12 +85,12 @@ The small size has a single centered column area, with 20px margins left and rig
 #### Medium 480 x 854
 The medium size has 12 columns, with 16px gutters.
 
-![Communication site medium grid](../images/design-grid-Communication-site–M-Canvas-16px-gutters.png)
+![Communication site medium grid](../images/design-grid-Communication-site-M-Canvas-16px-gutters.png)
 
 #### Large 640 x 1024
 The large size has 12 columns, with 24px gutters.
 
-![Communication site large grid](../images/design-grid-Communication-site–L-Canvas-24px-gutters.png)
+![Communication site large grid](../images/design-grid-Communication-site-L-Canvas-24px-gutters.png)
 
 #### XL 1024 x 768
 The XL size has a twelve columns, with 24px gutters.
@@ -147,6 +147,8 @@ The responsive grid for both team sites and communication sites adjusts when goi
 | 1600         | Web 1600x900            | XX-Large   | 12      | 32     | 3                       |
 | 1920         | Web 1920x1080           | XXX-Large  | 12      | 32     | 3                       |
 
+## See also
 
+- [Design toolkit and assets](https://developer.microsoft.com/en-us/fabric#/resources)
 
 

docs/docfx.json

@@ -35,8 +35,8 @@
       "extendBreadcrumb": "true",
       "breadcrumb_path":"/sharepoint/dev/breadcrumb/toc.json",
       "ms.suite": "office365",
-      "ms.author": "o365devx",
-      "author": "o365devx",
+      "ms.author": "spdevdocs",
+      "author": "spdevdocs",
       "ms.topic": "conceptual",
       "ms.prod": "sharepoint"
     },

docs/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online.md

@@ -155,7 +155,7 @@ Backing off is the fastest way to handle being throttled because SharePoint Onli
 
 
 
-For information about ways to monitor your SharePoint Online activity, see  [Diagnosing performance issues with SharePoint Online](http://msdn.microsoft.com/library/93502df4-552f-409b-971b-2e9b0f38588f.aspx).
+For information about ways to monitor your SharePoint Online activity, see  [Diagnosing performance issues with SharePoint Online](https://support.office.com/en-us/article/3c364f9e-b9f6-4da4-a792-c8e8c8cd2e86).
 
 
 
@@ -311,7 +311,7 @@ If we block your subscription, you'll see HTTP status code 503, and we'll notify
 <a name="BKMK_Additionalresources"> </a>
 
 
--  [Diagnosing performance issues with SharePoint Online](http://msdn.microsoft.com/library/93502df4-552f-409b-971b-2e9b0f38588f.aspx)
+-  [Diagnosing performance issues with SharePoint Online](https://support.office.com/en-us/article/3c364f9e-b9f6-4da4-a792-c8e8c8cd2e86)
 
 
 -  [Capacity planning and load testing SharePoint Online](http://msdn.microsoft.com/library/22fa7e7e-7554-4987-b56f-b39bbf303a0a.aspx)

docs/general-development/search-connector-framework-in-sharepoint.md

@@ -311,7 +311,7 @@ The connector framework also provides improved exception capturing and logging t
 -  [Enhancing the BDC model file for Search in SharePoint](enhancing-the-bdc-model-file-for-search-in-sharepoint.md)
 
 
--  [SharePoint: MyFileConnector custom BCS indexing connector sample](http://code.msdn.microsoft.com/SharePoint-MyFileConne-79d2ea26)
+-  [SharePoint 2013: MyFileConnector custom BCS indexing connector sample](https://code.msdn.microsoft.com/sharepoint-2013-myfileconne-79d2ea26)
 
 
 -  [How to: Crawl associated external content types in SharePoint](how-to-crawl-associated-external-content-types-in-sharepoint.md)