diff --git a/helix/devops/development/_static/basic-company-tds-deployment-build.png b/helix/devops/development/_static/basic-company-tds-deployment-build.png new file mode 100644 index 0000000..c082fea Binary files /dev/null and b/helix/devops/development/_static/basic-company-tds-deployment-build.png differ diff --git a/helix/devops/development/_static/basic-company-tds-deployment-sources.png b/helix/devops/development/_static/basic-company-tds-deployment-sources.png new file mode 100644 index 0000000..da5db6c Binary files /dev/null and b/helix/devops/development/_static/basic-company-tds-deployment-sources.png differ diff --git a/helix/devops/development/_static/basic-company-unicorn-hpp-reference.png b/helix/devops/development/_static/basic-company-unicorn-hpp-reference.png new file mode 100644 index 0000000..ab26954 Binary files /dev/null and b/helix/devops/development/_static/basic-company-unicorn-hpp-reference.png differ diff --git a/helix/devops/development/_static/image42.png b/helix/devops/development/_static/image42.png deleted file mode 100644 index 3d9e44f..0000000 Binary files a/helix/devops/development/_static/image42.png and /dev/null differ diff --git a/helix/devops/development/_static/image43.png b/helix/devops/development/_static/image43.png deleted file mode 100644 index 414507d..0000000 Binary files a/helix/devops/development/_static/image43.png and /dev/null differ diff --git a/helix/devops/development/_static/tds-content-file-sync.png b/helix/devops/development/_static/tds-content-file-sync.png new file mode 100644 index 0000000..73f4d2b Binary files /dev/null and b/helix/devops/development/_static/tds-content-file-sync.png differ diff --git a/helix/devops/development/local-deployment.rst b/helix/devops/development/local-deployment.rst index 84a3e3a..4f66e22 100644 --- a/helix/devops/development/local-deployment.rst +++ b/helix/devops/development/local-deployment.rst @@ -3,8 +3,8 @@ Local deployment One of the most frequently asked questions when working with Sitecore is whether to develop locally inside the web root or outside. Although the -general recommendation is to work outside the web root, a general -qualification is needed. +general recommendation is to work outside the web root, you should +consider the implications. There are two major aspects which should lead to choosing one or the other: @@ -15,8 +15,7 @@ importance of this separation cannot be overstated, as it will help in many aspects in the long run, such as general development, troubleshooting, upgrades and more. This separation is easier if the implementation specific files are physically separated from the files in -the standard frameworks etc. On the other hand, tools and processes -might cater for this separation, even when working inside the web root. +the standard frameworks etc. Generally, if tasks that are repeated frequently become taxing, they will be circumvented – and this will lead to inconsistencies in the @@ -28,15 +27,39 @@ frequency of this task it is imperative that this is easy. Tools and automated scripts can help this to become almost transparent for the developer. -.. admonition:: Habitat Example +.. admonition:: Sitecore Helix Examples - TDS - The build system in Habitat includes a number of tasks that will watch - files of a given type and deploy these automatically to the local - instance. This includes changes to assemblies after a build, changes to - .cshtml view files and changes to .css files. Habitat also includes - tasks for deploying all files of a given type. + The TDS version of Helix Basic Company uses the built-in + `capability of TDS `__ + to deploy files to the web root on build. To avoid the need for a + TDS project for modules which do not have associated items, a single + TDS project is used to build and deploy files for all solution modules. - .. figure:: _static/image43.png + .. figure:: _static/basic-company-tds-deployment-sources.png - Figure: All gulp tasks as available through the Visual Studio - Task Runner + Figure: Source web projects for file deployment + + .. figure:: _static/basic-company-tds-deployment-build.png + + Figure: File deployment location, originating in the ``TdsGlobal.config`` + + You can also enable the *Content File Sync* feature of TDS to automatically + deploy changes to any content files, such as Razor views and CSS/JS files. + + .. figure:: _static/tds-content-file-sync.png + + Figure: Configuring *Content File Sync* in *Tools > Options > TDS Options*. + +.. admonition:: Sitecore Helix Examples - Unicorn + + The Unicorn version of the Helix Basic Company uses the + `Helix Publishing Pipeline (HPP) `__ + open source tooling to enable publishing of the entire Helix solution as a + single unit, and to enable auto-publish to the web root on build. + + .. figure:: _static/basic-company-unicorn-hpp-reference.png + + Figure: Helix Publishing Pipeline reference in Helix Basic Company - Unicorn + + For information on configuring auto-publishing with HPP, see its + `documentation `__. \ No newline at end of file