GITBOOK-11: No subject

Author: Sofie Toft Kristensen

13/umbraco-deploy/README.md

@@ -2,26 +2,26 @@
 description: Documentation on how to work with Umbraco Deploy.
 ---
 
-# What is Umbraco Deploy?
+# Umbraco Deploy Documentation
 
 Umbraco Deploy is a deployment tool that helps you with the process of transferring code and data between multiple environments. Deploy can be configured for many different setups and is great for both small setups as well as large and more complex infrastructures.
 
-<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Set up Umbraco Deploy</strong></td><td>Learn how you can set up Umbraco Deploy on new and existing Umbraco projects.</td><td><a href=".gitbook/assets/update.png">update.png</a></td><td><a href="installation/install-configure.md">installation/install-configure.md</a></td></tr><tr><td><strong>Deployment workflow in</strong></td><td>Learn about how the Deployment workflow in Umbraco Deploy work.</td><td><a href=".gitbook/assets/lightbulb.png">lightbulb.png</a></td><td><a href="deployment-workflow/">deployment-workflow</a></td></tr><tr><td><strong>Upgrading</strong></td><td>Learn how you can upgrade Umbraco Deploy.</td><td><a href=".gitbook/assets/code_cursor.png">code_cursor.png</a></td><td><a href="upgrades/">upgrades</a></td></tr></tbody></table>
+<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Set up Umbraco Deploy</strong></td><td>Learn how you can set up Umbraco Deploy on new and existing Umbraco projects.</td><td><a href=".gitbook/assets/update.png">update.png</a></td><td><a href="installation/install-configure.md">install-configure.md</a></td></tr><tr><td><strong>Deployment workflow in</strong></td><td>Learn about how the Deployment workflow in Umbraco Deploy work.</td><td><a href=".gitbook/assets/lightbulb.png">lightbulb.png</a></td><td><a href="deployment-workflow/">deployment-workflow</a></td></tr><tr><td><strong>Upgrading</strong></td><td>Learn how you can upgrade Umbraco Deploy.</td><td><a href=".gitbook/assets/code_cursor.png">code_cursor.png</a></td><td><a href="upgrades/">upgrades</a></td></tr></tbody></table>
 
 {% embed url="https://www.youtube-nocookie.com/embed/Fqfc-UL4q5U" %}
 Umbraco Deploy Overview
 {% endembed %}
 
-{% content-ref url="getting-started/deploy-settings.md" %}
-[getting-started/deploy-settings.md](getting-started/deploy-settings.md)
+{% content-ref url="deploy-settings.md" %}
+[deploy-settings.md](deploy-settings.md)
 {% endcontent-ref %}
 
-{% content-ref url="getting-started/extending.md" %}
-[getting-started/extending.md](getting-started/extending.md)
+{% content-ref url="extending/extending.md" %}
+[extending.md](extending/extending.md)
 {% endcontent-ref %}
 
 {% content-ref url="troubleshooting.md" %}
-[getting-started/troubleshooting.md](troubleshooting.md)
+[troubleshooting.md](troubleshooting.md)
 {% endcontent-ref %}
 
 Umbraco Deploy is also the engine that runs behind the scenes on [Umbraco Cloud](https://docs.umbraco.com/umbraco-cloud/). Here it takes care of all the deployment processes of both code, schema and content on projects.

13/umbraco-deploy/SUMMARY.md

@@ -4,6 +4,7 @@
 * [Legacy Documentation](legacy-documentation.md)
 * [Release notes](release-notes.md)
 * [Troubleshooting](troubleshooting.md)
+* [Configuration](deploy-settings.md)
 
 ## Installation
 
@@ -22,9 +23,6 @@
   * [Azure DevOps](getting-started/cicd-pipeline/ci-cd-azure-dev-ops.md)
   * [Github actions](getting-started/cicd-pipeline/ci-cd-github-actions.md)
 * [Streamlining Local Development](getting-started/streamlining-local-development.md)
-* [Configuration](getting-started/deploy-settings.md)
-* [Extending](getting-started/extending.md)
-* [Handling Cache Refresher Notifications](getting-started/handling-cache-refresher-notifications.md)
 
 ## Deployment Workflow
 
@@ -38,3 +36,8 @@
 * [Restoring content](deployment-workflow/restoring-content/README.md)
   * [Partial Restores](deployment-workflow/restoring-content/partial-restore.md)
 * [Deploy Dashboard](deployment-workflow/deploy-dashboard.md)
+
+## Extending
+
+* [Extend Deploy](extending/extending.md)
+* [Handling Cache Refresher Notifications](extending/handling-cache-refresher-notifications.md)

13/umbraco-deploy/getting-started/deploy-settings.md renamed to 13/umbraco-deploy/deploy-settings.md

@@ -51,7 +51,7 @@ Media items are transferred the same way as content:
 
 ### Umbraco Forms
 
-In order for Deploy to handle Forms data as content, you will need to ensure that the `transferFormsAsContent` setting in configuration is set to `true`. See details in the [Deploy Settings for Umbraco 9+](../getting-started/deploy-settings.md) article.
+In order for Deploy to handle Forms data as content, you will need to ensure that the `transferFormsAsContent` setting in configuration is set to `true`. See details in the [Deploy Settings for Umbraco 9+](../deploy-settings.md) article.
 
 Once the setting have been added to the source and target environment forms can be transferred the same way as content and media:
 

13/umbraco-deploy/deployment-workflow/content-transfer.md

@@ -16,7 +16,7 @@ Here you can see whether the latest deployment has been completed or failed. You
 
 ## Deploy Operations
 
-With the Deploy operations, you can run different operations in Umbraco Deploy. 
+With the Deploy operations, you can run different operations in Umbraco Deploy.
 
 <figure><img src="../.gitbook/assets/image (3).png" alt=""><figcaption><p>The different Deploy operations.</p></figcaption></figure>
 
@@ -48,7 +48,7 @@ This operation is useful if you want to move to another Umbraco instance and mig
 
 ## Configuration Details
 
-In the Configuration details, you can see how Umbraco Deploy has been [configured](../getting-started/deploy-settings.md) on your environment. You get an overview of the Setting options, the current value(s), and notes help you understand each of the settings. Updates to the need to be applied in the `appsettings.json` file.
+In the Configuration details, you can see how Umbraco Deploy has been [configured](../deploy-settings.md) on your environment. You get an overview of the Setting options, the current value(s), and notes help you understand each of the settings. Updates to the need to be applied in the `appsettings.json` file.
 
 <figure><img src="../.gitbook/assets/image (2).png" alt=""><figcaption><p>Example of Umbraco Deploy configuration.</p></figcaption></figure>
 

13/umbraco-deploy/deployment-workflow/deploy-dashboard.md

@@ -1,6 +1,7 @@
 ---
 description: >-
-  Get an overview of the things changed and fixed in each version of Umbraco Deploy.
+  Get an overview of the things changed and fixed in each version of Umbraco
+  Deploy.
 ---
 
 # Release notes
@@ -87,7 +88,7 @@ This section contains the release notes for Umbraco Deploy 13 including all chan
 #### [13.0.3](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.3) (January 16th 2024)
 
 * Added configurable option to avoid overwriting of dictionary items with empty values [#191](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/191)
-    * For more details see the page on [Deploy's settings](./getting-started/deploy-settings.md).
+  * For more details see the page on [Deploy's settings](deploy-settings.md).
 * Fixed regression issue with transfer of date values.
 
 #### [13.0.2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.2) (January 9th 2024)

13/umbraco-deploy/getting-started/extending.md renamed to 13/umbraco-deploy/extending/extending.md

@@ -38,25 +38,25 @@ In addition to transferring content via the backoffice, it is possible to move b
 
 As this process requires less inter-environment communication, it's possible to transfer much larger amounts of content without running into the hard platform limits.
 
-[Read more about the import/export feature here](./deployment-workflow/import-export.md).
+[Read more about the import/export feature here](deployment-workflow/import-export.md).
 
 ### Review timeouts
 
-Firstly, you can review and update the [timeout settings available with Deploy](./getting-started/deploy-settings.md#timeout-settings). Increasing these from the default values may help, but won't necessarily resolve all issues. This is because, as noted, some timeouts are fixed values set by the hosting environment.
+Firstly, you can review and update the [timeout settings available with Deploy](deploy-settings.md#timeout-settings). Increasing these from the default values may help, but won't necessarily resolve all issues. This is because, as noted, some timeouts are fixed values set by the hosting environment.
 
 ### Use batch configurations
 
 There are two places where Deploy operations can be batched. This allows breaking up of a single, long process into multiple, smaller ones. By doing this it's possible to complete each smaller operation within the platform imposed timeout.
 
 #### For transfers to upstream environments
 
-If transferring items from a downstream environment to an upstream one, it's possible to [configure a batch size](./getting-started/deploy-settings.md#batch-settings). With this in place, transfers will be batched into separate operations, allowing each single operation to complete before any hosting environment-enforced timeout.
+If transferring items from a downstream environment to an upstream one, it's possible to [configure a batch size](deploy-settings.md#batch-settings). With this in place, transfers will be batched into separate operations, allowing each single operation to complete before any hosting environment-enforced timeout.
 
 This will take effect only for transfers to upstream environments and when multiple items are selected in the backoffice. An example is the selection of a single media folder containing many files.
 
 #### For processing of a Deploy "package"
 
-A package is an ordered structure containing all the items selected for a Deploy operation, plus all the determined dependencies and relations. The processing of this package in the target environment can also be batched via a [configuration setting](./getting-started/deploy-settings.md#batch-settings).
+A package is an ordered structure containing all the items selected for a Deploy operation, plus all the determined dependencies and relations. The processing of this package in the target environment can also be batched via a [configuration setting](deploy-settings.md#batch-settings).
 
 When set, if the number of items determined for the package exceeds the batch size, the processing will be chunked into batches.
 
@@ -76,27 +76,27 @@ Deploy will do comparisons between the entities in different environments to det
 
 If a lot of files need to be checked, this can be slow, and a faster option is available that uses the file metadata. The only downside of changing this option is a marginally increased chance of Deploy considering a media file hasn't changed when it has. This would omit it from the deployment.
 
-This option can be [set in configuration](./getting-started/deploy-settings.md#mediafilechecksumcalculationmethod).
+This option can be [set in configuration](deploy-settings.md#mediafilechecksumcalculationmethod).
 
 ### Consider disabling cache refresher notifications
 
 When a Deploy operation completes, cache refresher notifications are fired. These are used to update Umbraco's cache and search index.
 
 In production these should always be enabled, to ensure these additional data stores are kept up to date.
 
-If attempting a one-off, large transfer operation, before a site is live, you could disable these via a [configuration setting](./getting-started/deploy-settings.md#suppresscacherefreshernotifications). That would omit the firing and handling of these notifications and remove their performance overhead. Following which you would need to ensure to rebuild the cache and search index manually via the backoffice _Settings_ dashboards.
+If attempting a one-off, large transfer operation, before a site is live, you could disable these via a [configuration setting](deploy-settings.md#suppresscacherefreshernotifications). That would omit the firing and handling of these notifications and remove their performance overhead. Following which you would need to ensure to rebuild the cache and search index manually via the backoffice _Settings_ dashboards.
 
 ### Review relation types included in deploy operations
 
 As well as transferring entities between environments Deploy will also include the relations between them. As of 10.1.2 and 11.0.1, two relation types used for usage tracking are omitted by default. These do not need to be transferred as they are recreated by the CMS as part of the save operation on the entity.
 
-If using an earlier version, or to make further adjustments, modify the [settings for relation types](./getting-started/deploy-settings.md#relationtypes) in configuration.
+If using an earlier version, or to make further adjustments, modify the [settings for relation types](deploy-settings.md#relationtypes) in configuration.
 
 ## Path too long exceptions
 
 When restoring between different media systems exceptions can occur due to file paths. They can happen between a local file system and a remote system based on blob storage. What is accepted on one system may be rejected on another as the file path is too long. Normally this will only happen for files with particularly long names.
 
-If you are happy to continue without throwing exceptions in these instances you can [modify the configuration](./getting-started/deploy-settings.md#continueonmediafilepathtoolongexception). If this is done such files will be skipped, and although the media item will exist there will be no associated file.
+If you are happy to continue without throwing exceptions in these instances you can [modify the configuration](deploy-settings.md#continueonmediafilepathtoolongexception). If this is done such files will be skipped, and although the media item will exist there will be no associated file.
 
 ## Schema files following upgrades
 

13/umbraco-deploy/getting-started/handling-cache-refresher-notifications.md renamed to 13/umbraco-deploy/extending/handling-cache-refresher-notifications.md

@@ -1,6 +1,7 @@
 ---
 description: >-
-  Version specific documentation for upgrading to new major versions of Umbraco Deploy.
+  Version specific documentation for upgrading to new major versions of Umbraco
+  Deploy.
 ---
 
 # Version Specific Upgrade Details
@@ -25,7 +26,7 @@ Version 13 contains a number of breaking changes. We don't expect many projects
 
 #### **Configuration**
 
-* [Configuration of relations](../getting-started/deploy-settings.md#relationtypes) was changed from a list to a dictionary.
+* [Configuration of relations](../deploy-settings.md#relationtypes) was changed from a list to a dictionary.
 
 ```json
 // Before
@@ -47,7 +48,7 @@ Version 13 contains a number of breaking changes. We don't expect many projects
 },
 ```
 
-* [Configuration of value connectors](../getting-started/deploy-settings.md#valueconnectors) was changed from a list to a dictionary.
+* [Configuration of value connectors](../deploy-settings.md#valueconnectors) was changed from a list to a dictionary.
 
 ```json
 // Before
@@ -83,4 +84,4 @@ These updates are more minor. We don't expect many projects to be affected by th
 
 ## Legacy version specific upgrade notes
 
-You can find the version specific upgrade notes for versions out of support in the [Legacy documentation on Github](https://github.com/umbraco/UmbracoDocs/blob/umbraco-eol-versions/11/umbraco-deploy/upgrades/version-specific.md). 
+You can find the version specific upgrade notes for versions out of support in the [Legacy documentation on Github](https://github.com/umbraco/UmbracoDocs/blob/umbraco-eol-versions/11/umbraco-deploy/upgrades/version-specific.md).