Add article o n promotion limitations (codefresh-io#1318)

* Add article o n promotion limitations

Added new article on promotion limitations

* Update promotion-limitations.md

* Update promotion-limitations.md

_data/argohub-nav.yml

@@ -254,6 +254,8 @@
       url: "/promotion-components"
     - title: Promotion setup guidelines
       url: "/create-promotion-sequence"
+    - title: Promotion limitations
+      url: "/promotion-limitations"      
     - title: Promotion Flows
       url: "/promotion-flow"
     - title: Promotion Policies

_data/nav.yml

@@ -431,6 +431,8 @@
       url: "/promotion-components"
     - title: Promotion setup guidelines
       url: "/create-promotion-sequence"
+    - title: Promotion limitations
+      url: "/promotion-limitations"   
     - title: Promotion Flows
       url: "/promotion-flow"  
     - title: Promotion Policies

_docs/promotions/create-promotion-sequence.md

@@ -10,7 +10,7 @@ This article outlines the tasks required to configure, trigger, and monitor prom
 
 Promotions are a critical part of continuous delivery, enabling you to move changes through environments while meeting deployment and compliance requirements. A successful promotion sequence depends on key components that define and orchestrate the promotion flow. To review these components, see [Promotion building blocks]({{site.baseurl}}/docs/promotions/promotion-components/).
 
-
+For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
 
 ## Prerequisites
 1. [Configuration Runtime]({{site.baseurl}}/docs/installation/gitops/configuration-runtime/)  

_docs/promotions/product-promotion-props.md

@@ -78,7 +78,8 @@ Review [examples of promotable properties]({{site.baseurl}}/docs/products/promot
 
 For details, see [Configuring properties for promotion across applications]({{site.baseurl}}/docs/products/promotion-version-properties/#configuring-properties-for-promotion-across-applications).
 
-
+>**NOTE**  
+For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
 
 ## Concurrent promotion behavior for product
 
@@ -119,3 +120,4 @@ Assigning flows and defining their triggers ensure that changes to the product a
 ## Related articles
 [Configure Product Settings]({{site.baseurl}}/docs/products/configure-product-settings/)  
 [Create products]({{site.baseurl}}/docs/products/create-product/)  
+[Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/)  

_docs/promotions/product-releases.md

@@ -81,6 +81,7 @@ Release notes compile changes from various sources into a single view, enabling
 See [Analyze change history in Release Notes](#analyze-change-history-in-release-notes).
 
 
+
 ## View releases for products
 
 The Releases tab for a product displays the releases for that product, whether successful or failed.
@@ -421,6 +422,7 @@ max-width="60%"
 ## Related articles
 [Promotion Flows]({{site.baseurl}}/docs/promotions/promotion-flow/)  
 [Trigger promotions]({{site.baseurl}}/docs/promotions/trigger-promotions/)   
+[Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/)  
 [Promotion quick starts]({{site.baseurl}}/docs/gitops-quick-start/promotions/)  
 [Promotions: Setup & configuration guidelines]({{site.baseurl}}/docs/promotions/create-promotion-sequence/)
 

_docs/promotions/promotion-components.md

@@ -19,7 +19,7 @@ For an end-to-end guide on continuous delivery with Codefresh GitOps, see [Promo
 A promotion comprises several entities, some optional and some required, that define its behavior.
 
 The table below summarizes the core entities and promotion-specific entities, outlining their roles in the promotion process.
-
+For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
 
 ### Core entities for promotions
 These entities define the structure of your deployment.<br>They support standard promotion flows, enabling typical deployment scenarios such as promotions between two environments. See our [quick starts on promotions]({{site.baseurl}}/docs/gitops-quick-start/gitops-quick-start/#promoting-applications).

_docs/promotions/promotion-flow.md

@@ -110,7 +110,7 @@ max-width="60%"
 
 ## Promotion Flow behavior: Key insights
 Here are a few useful factors to be aware of when creating Promotion Flows.  
-
+For details on current limitations, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
 
 ### Environments in Promotion Flows
 

_docs/promotions/promotion-limitations.md

@@ -0,0 +1,25 @@
+---
+title: "Promotion limitations"
+description: "Review the current limitations when working with promotions"
+group: promotions
+toc: true
+---
+
+
+## Current limitations for promotions
+The table below lists the current limitations when working with promotions.
+
+{: .table .table-bordered .table-hover}
+| Item                     | Limitation            |
+| --------------         | --------------           |
+|Git providers           | GitHub only.<br>The following Git-based actions are supported:{::nomarkdown}<ul><li>Opening a pull request (PR)</li><li>Adding Git commit status updates with a link to the release</li></ul>{:/}|
+|Argo Rollouts           | Partially supported.<br>{::nomarkdown}<ul><li>An application that reports a Healthy status may trigger the next stage in the promotion before the rollout is complete.</li><li>Promotion release fails if Argo Rollout remains in Processing state for over two hours</li></ul>{:/}|
+|Multi-source applications           | Not supported.<br>{::nomarkdown}<ul><li>Promotions are not supported for Argo CD applications with multiple sources (multi-source applications).</li></ul>{:/}|
+|Promotable files & properties       | {::nomarkdown}<ul><li><b>File scope</b>:<br>Only files in the root or a subdirectory of the <a href="https://codefresh.io/docs/docs/deployments/gitops/application-configuration-settings/#source"> Argo CD application source</a> can be promoted. Files outside this scope are ignored.</li><li><b>Value overrides</b>:<br> Inline value overrides in the application manifest, by adding `values:` in `spec.source.helm` for example, are not supported for promotion.</li></ul>{:/}|
+
+## Related articles
+[About promotions]({{site.baseurl}}/docs/promotions/promotions-overview/)  
+[Configure Promotion Flows]({{site.baseurl}}/docs/promotions/promotion-flow/)  
+[Trigger promotions]({{site.baseurl}}/docs/promotions/trigger-promotions/)   
+[Tracking product promotions through releases]({{site.baseurl}}/docs/promotions/product-releases/)  
+[Promotions: Setup & configuration guidelines]({{site.baseurl}}/docs/promotions/create-promotion-sequence/)  

_docs/promotions/promotions-overview.md

@@ -23,7 +23,7 @@ max-width="60%"
 Watch this video to see a promotion in action: 
 <iframe width="560" height="315" src="https://www.youtube.com/embed/4isYoutmRco?si=EDSfZFQQ4Dp5gw6i" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe> 
 
-<!--- {::nomarkdown}<img src=../../../images/icons/video-play-icon-blue.svg?display=inline-block>{:/} [Drag-and-drop Promotion](https://www.youtube.com/watch?v=4isYoutmRco&t=1s){:target="\_blank"} -->
+
 
 
 
@@ -56,7 +56,9 @@ max-width="65%"
 %}
 
 >**NOTE**  
-Promotions in Codefresh GitOps require Runtime version 0.13.4 or higher. Ensure your runtime is updated to access  promotion features.
+Promotions in Codefresh GitOps require Runtime version 0.13.4 or higher. Ensure your Runtime is updated to access promotion features.  
+
+For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
 
 
 ## Key features with GitOps promotions

_docs/promotions/trigger-promotions.md

@@ -22,7 +22,7 @@ Manual promotion offer different levels of control, accessible from distinct are
 
 The [quick reference for manual promotion triggers](#manual-promotion-triggers-quick-reference) provides details on the different options, where you can find them, and potential use cases for each. How-to details are in the sections that follow the quick reference.
 
-
+For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
 
 ## Manual promotion triggers: quick reference
 

_gitops/promotions/promotion-limitations.md

@@ -0,0 +1 @@
+../../_docs/promotions/promotion-limitations.md

assets/js/src/argohub-redirect-mapping.json

@@ -120,5 +120,6 @@
   "/docs/products/promotion-concurrency/": "/gitops/products/promotion-concurrency/",
   "/docs/promotions/promotion-context-promotion-workflows/": "/gitops/promotions/promotion-context-promotion-workflows/",
   "/docs/promotions/service-accounts-promotion-workflows/": "/gitops/promotions/service-accounts-promotion-workflows/",
-  "/docs/installation/gitops/runtime-install-with-new-argo-cd/": "/gitops/gitops-runtimes/runtime-install-with-new-argo-cd/"
+  "/docs/installation/gitops/runtime-install-with-new-argo-cd/": "/gitops/gitops-runtimes/runtime-install-with-new-argo-cd/",
+  "/docs/promotions/promotion-limitations/": "/gitops/promotions/promotion-limitations/"
 }