Merge branch 'master' into DOC_131-Algolia

Author: markzegarelli

src/_data/sidenav/strat.yml

@@ -83,8 +83,8 @@ sections:
   section:
   - path: /connections/sources/catalog/libraries/website/javascript
     title: Analytics.js (Javascript) Source
-  # - path: /connections/sources/catalog/libraries/website/javascript/analytics-js-2
-  #   title: Analytics.js 2.0 (Beta)
+  - path: /connections/sources/catalog/libraries/website/javascript/analytics-js-2
+    title: Analytics.js 2.0 (Beta)
   - path: /connections/sources/catalog/libraries/website/javascript/supported-browsers
     title: Analytics.js supported browsers
   - path: /connections/sources/catalog/libraries/website/javascript/quickstart

src/_release_notes/2021-03-10-ajs-2.md

@@ -0,0 +1,20 @@
+---
+title: Analytics.js 2.0
+description: |
+  Analytics.js is Segment’s most popular library source. This new major version has been re-engineered to be more performant and provide greater extensibility. It is fully backwards compatible with the previous version of Analytics.js.
+release_type: beta
+product_area: sources
+business: false
+team: false
+doc_links:
+  - 
+    title: Analytics.js 2.0 (Beta)
+    url: "/docs/connections/sources/catalog/libraries/website/javascript/analytics-js-2/"
+# images:
+#   -
+#     path: /images/release-notes/ui-update-1.png
+#     desc: The navigation was redesigned to better reflect how users navigate through the product.
+#   - 
+#     path: /images/release-notes/ui-update-2.gif
+#     desc: A new workspace switcher provides an easier way to navigate between workspaces.
+---

src/_sass/vendors/_premonition.scss

@@ -103,9 +103,9 @@
       margin-top: 0px;
     }
 
-    & > *:not(.header, ul) + * {
-      margin-top: 25px;
-    }
+    // & > *:not(.header, ul) + * {
+    //   margin-top: 25px;
+    // }
 
     & > * + * {
       margin-top: 5px;

src/connections/destinations/catalog/google-cloud-function/index.md

@@ -7,7 +7,7 @@ strat: google
 
 Segment makes it easy to send your data to Google Cloud Function (and lots of other destinations). Once you collect your data using Segment's [open source libraries](/docs/connections/sources/catalog/), Segment translates and routes your data to Google Cloud Function in a format it can use.
 
-[Google Cloud Function](https://cloud.google.com/function) is a lightweight compute solution for developers to create single-purpose, stand-alone functions that respond to Cloud events without the need to manage a server or runtime environment.
+[Google Cloud Function](https://cloud.google.com/functions) is a lightweight compute solution for developers to create single-purpose, stand-alone functions that respond to Cloud events without the need to manage a server or runtime environment.
 
 {% include content/beta-note.md %}
 

src/connections/sources/catalog/libraries/website/javascript/analytics-js-2.md

@@ -1,7 +1,6 @@
 ---
 title: Analytics.js 2.0 (Beta)
 strat: ajs
-hidden: true
 ---
 > warning "Analytics.js 2.0 is recommended for use in staging"
 > Analytics.js 2.0 was built with backwards compatibility in mind. However, Segment recommends thorough testing in a Staging environment before you upgrade your production source.
@@ -42,6 +41,20 @@ Once enabled, after 5 minutes or less, the updated code is delivered.
 
 To revert back to the previous version of Analytics.js, disable the Analytics 2.0 toggle on any source you've enabled it.
 
+## Cases that require manual upgrade 
+There are two cases where upgrading to Analytics.js 2.0 requires manual effort beyond enabling the Analytics.js 2.0 toggle.
+
+### When using in-domain instrumentation CDN aliasing
+
+If the source you intend to upgrade uses the in-domain instrumentation as well as a custom "Alias for analytics.js", then you should update the AJS snippet to the latest version (4.13.2 or higher) before you toggle on Analytics.js 2.0. 
+
+### When using a strict content security policy on the page 
+
+Analytics.js 2.0 asynchronously loads different pieces of the library as needed. If the source you're upgrading uses a strict Content Security Policy (CSP) that allows Javascript to be downloaded from specific locations, then you need to update the CSP to account for all the pieces used for Analytics.js 2.0. Therefore, beyond allowing the main analytics.min.js script, you should allow the following paths in your CSP: 
+- `https://cdn.segment.com/v1/projects/<WRITE_KEY>/settings`
+- `https://cdn.segment.com/analytics-next/bundles/*` 
+- `https://cdn.segment.com/next-integrations/integrations/*`
+
 ## Open source libraries
 
 Analytics.js 2.0 includes the following open source components:

src/connections/sources/catalog/libraries/website/javascript/index.md

@@ -9,6 +9,9 @@ strat: ajs
 
 Analytics.js, Segment's Javascript source, makes it simple to send your data to any tool without having to learn, test or implement a new API every time.
 
+> info "Analytics.js 2.0 Beta"
+> A new version of Analytics.js is available for use in Beta. Click [here](/docs/connections/sources/catalog/libraries/website/javascript/analytics-js-2) for more information.
+
 ## Getting Started
 
 Read through the [Analytics.js QuickStart Guide](/docs/connections/sources/catalog/libraries/website/javascript/quickstart/) which explains how to add Analytics.js to your site in just a few minutes. Once you've installed the library, read on for the detailed API reference!

src/connections/sources/index.md

@@ -174,5 +174,7 @@ We'd love to know what other sources of data you'd like to analyze. [Contact the
 ---
 
 ## Visual Tagger (Beta)
+> warning "Visual Tagger entering maintenance mode"
+> For more information, see the [Visual Tagger documentation](/docs/connections/sources/visual-tagger).
 
 [Getting started with Segment Visual Tagger](/docs/connections/sources/visual-tagger)

src/connections/sources/visual-tagger.md

@@ -1,6 +1,21 @@
 ---
 title: Visual Tagger
 ---
+> warning "Visual Tagger entering maintenance mode"
+> Visual Tagger is entering maintenance mode on **April 5th, 2021**.
+> 
+> You can continue to use Visual Tagger with sources on which it's already enabled. However, the feature will no longer be available to new Segment customers and existing customers will not be able to add new Visual Tagger sources.
+> 
+> Segment is committed to enabling customers to collect and deliver high quality customer data to the tools they need to run their businesses. As a CSS-based event tracking method, Visual Tagger has limitations that can prevent detailed data from being consistently collected. For code-based collection best practices, see the [Segment Spec](/docs/connections/spec).
+> 
+> Going forward, support for the feature will include:
+> - Free, Team, and Startup customers will receive support with issues that impact multiple customers, but will not receive CSS-selector related troubleshooting
+> - Business customers will continue to receive full support
+> 
+> 
+> The following best practices can make your website more compatible with the feature and eliminate common issues:
+> - Assign unique IDs to all elements you intend to tag with Visual Tagger
+> - Adhere to HTML standards, such as forms inclosed in a `<form>` tag, and submitted with an `<input type="submit">` button.
 
 Visual Tagger is a tool that enables you to collect data about what your customers are doing on your websites without having to write any code. Specifically, it helps you implement `track` events by pointing and clicking on parts of your website.