Merge pull request #3 from segmentio/develop

sync fork

Author: jkaho

.env.example

@@ -6,4 +6,4 @@ CONTEXT=development
 PLATFORM_API_TOKEN=generate a token from your Segment workspace
 PAPI_TOKEN=generate a token from your Segment workspace
 ALGOLIA_APP_ID=
-ALGOLIA_SEARCH_KEY=
+ALGOLIA_SEARCH_KEY=

.github/styles/Vocab/Docs/accept.txt

@@ -22,6 +22,7 @@ Aampe
 adset
 Adwords
 Aircall
+Airdat(?:e|es)
 Algolia
 allowlist
 Amberflo
@@ -33,22 +34,28 @@ Automations
 aws
 background(?:ed|ing)
 Bento
+Bing
+Blackbaud
 Blitzllama
 blocklist
 Bluedot
 bool
 boolean
+Braze's
 Breyta
 Chargebee
 chatbot
 cli
 CloudFront
 Cocoapods
+comScore
 Contentful
+Cordova
 Criteo
 csv
 Databricks
 datetime
+debouncing
 deeplink
 Dev
 Doubleclick
@@ -99,6 +106,7 @@ Marketo
 Matcha
 matchers
 measurability
+Metrix
 middleware
 Middleware
 Mixpanel
@@ -122,6 +130,7 @@ performant
 Pinterest
 Pipedrive
 Preact
+Proguard
 Qualtrics
 reformat(:?s)
 remarket

.tool-versions

@@ -0,0 +1 @@
+ruby 2.7.8

.yarn/cache/ansi-regex-npm-2.1.1-ddd24d102b-190abd03e4.zip

@@ -21,55 +21,33 @@ CODEOWNERS  @segmentio/segment-doc-team
 
 
 # Libraries owners
-/src/connections/catalog/libraries @stayseesong @markzegarelli
+/src/connections/catalog/libraries @stayseesong
 
 
 # Destinations owners
-/src/connections/destinations  @stayseesong @markzegarelli
+# /src/connections/destinations  @stayseesong=
 
 # Stratconn
 ## Adobe
-/src/connections/destinations/catalog/adobe-analytics/ @kdaswani
-/src/connections/destinations/catalog/actions-adobe-target-web/ @kdaswani
-/src/connections/destinations/catalog/actions-adobe-target-cloud/ @kdaswani
-/src/connections/destinations/catalog/marketo-v2/ @kdaswani
-/src/connections/destinations/catalog/marketo-static-lists/ @kdaswani
+
 
 ## Facebook
-/src/connections/destinations/catalog/facebook-pixel/ @kdaswani
-/src/connections/destinations/catalog/actions-facebook-conversions-api/ @kdaswani
-/src/connections/destinations/catalog/facebook-app-events/ @kdaswani
-/src/connections/destinations/catalog/facebook-offline-conversions/ @kdaswani
-/src/connections/destinations/catalog/personas-facebook-custom-audiences/ @kdaswani
+
 
 ## Google
-/src/connections/destinations/catalog/firebase/ @kdaswani
-/src/connections/destinations/catalog/google-analytics/ @kdaswani
-/src/connections/destinations/catalog/actions-google-analytics-4/ @kdaswani
-/src/connections/destinations/catalog/google-tag-manager/ @kdaswani
-/src/connections/destinations/catalog/actions-google-enhanced-conversions/ @kdaswani
-/src/connections/destinations/catalog/doubleclick-floodlight/ @kdaswani
-/src/connections/destinations/catalog/google-ads-classic/ @kdaswani
-/src/connections/destinations/catalog/google-ads-gtag/ @kdaswani
-/src/connections/destinations/catalog/google-cloud-function/ @kdaswani
-/src/connections/destinations/catalog/google-cloud-pubsub/ @kdaswani
-/src/connections/destinations/catalog/adwords-remarketing-lists/ @kdaswani
-/src/connections/destinations/catalog/personas-display-video-360/ @kdaswani
+
 
 ## Salesforce
-/src/connections/destinations/catalog/salesforce/ @kdaswani
-/src/connections/destinations/catalog/actions-salesforce/ @kdaswani
-/src/connections/destinations/catalog/salesforce-marketing-cloud/ @kdaswani
-/src/connections/destinations/catalog/pardot/ @kdaswani
+
 
 # Engage
-/src/engage/ @markzegarelli @pwseg @rchinn-segment
+/src/engage/ @pwseg 
 
-# Personas owners 
-/src/personas @pwseg @rchinn-segent
+# Unify
+/src/unify @pwseg 
 
 # Protocols owners
 /src/protocols @forstisabella
 
 # Storage owners
-/src/connections/storage @forstisabella
+/src/connections/storage @forstisabella

.yarn/cache/ansi-styles-npm-2.2.1-f3297e782c-ebc0e00381.zip

@@ -41,7 +41,7 @@ The most interesting ones are:
 
 **Save all images locally! No linking to third-party hosted images!** Images are published to our CDN from the build step, and this means they won't go missing if the hosting service dujour goes out of business.
 
-There are no _enforced_ naming conventions at this time. Files that start with an underscore are ignored by Jekyll. Anything you see with `asset` was dowloaded by a script to migrate it out of Contents.io.
+There are no _enforced_ naming conventions at this time. Files that start with an underscore are ignored by Jekyll. Anything you see with `asset` was downloaded by a script to migrate it out of Contents.io.
 
 In general, it's a good practice to name images with a description that helps you (& other docs maintainers) figure out where they should go within a page, or within a larger folder of images.
 
@@ -77,6 +77,16 @@ Sources pages check if the source is a cloud-app, then include information about
 
 Content with in each `.md` file is markdown. For information about styling, and available extensions, see `_src/utils/formatguide.md` or the live version [here](https://segment.com/docs/utils/formatguide).
 
+## Building a preview
+
+Netlify allows you to build a preview environment on any PR you create in GitHub. This is helpful when you want to send out a review, and the formatting and design are important to those reviewers. 
+
+To build a preview site, add `[netlify-build]` to a commit message on your PR. Here's an example of what the preview build will look like: 
+
+https://github.com/segmentio/segment-docs/pull/6051#issuecomment-1942723573 
+
+You can rebuild the preview by adding a new commit with  `[netlify-build]` in the commit message. 
+
 ### Front matter
 
 Repository Markdown files often contain front matter metadata, which you'll find at the top of the file. These front matter variables instruct Jekyll how to build and render the page as HTML.
@@ -101,7 +111,7 @@ Front matter variables have unique functions, including the following:
 - `hide-personas-partial`: defaults to false. When true, hides the section of content from `destination-footer.md` that talks about being able to receive personas data.
 - `integration_type`: This is set in the `_config.yml` on three paths to add a noun (Source, Destination, or Warehouse) to the end of the title, and the end of the title tag in the html layout. It also controls the layout and icon for some of these.
 - `source-type`: These are only used to supplement when a Cloud App in the sources path doesn't appear in the Config API list, and needs its type explicitly set. It runs some logic in the `cloud-app-note.md` to explain which cloud-apps are object vs event sources.
-
+- `private`: Used to indicate that a destination is not publicly available (Private Beta or Pilot status), and is not available in the public catalog. When `private: true`, the build pulls integration metadata from `src/_data/catalog/destinations_private.yml`. To update the list of private destinations, use the `make private_destination` command, and enter the integration's ID when prompted.
 #### Utility front matter
 - `published`: defaults to true. Set this to "false" to prevent Jekyll from rendering an HTML page for this file. Good for when you're working on something in the repo but aren't ready to release it yet, and don't want to use a Draft PR.
 - `hidden`: omits the file from the `sitemap.xml`, adds a `<meta name="robots" content="noindex" />` to the top of the generated HTML file, and drops it from the convenience script for regenerating the nav.
@@ -112,3 +122,4 @@ Front matter variables have unique functions, including the following:
 - `redirect_from`: Defaults to null. Takes an array of URLs from the front matter in a file, and generates a "stub" page at each URL at build-time. Each stub file redirects to the original file. Use the path from the root of the content directory, for example `/connections/destinations/catalog/` rather than `/docs/connections/destinations/catalog/`. **Note** We are mostly using NGINX redirects for SEO purposes. Approximately quarterly, we'll collect these and add them to NGINX.
 - `seo-changefreq`: default: `weekly `. Use the values [in the sitemap spec](https://www.sitemaps.org/protocol.html#xmlTagDefinitions). - sets the `changefreq` tag in the sitemap.xml generator, which tells search crawlers how often to check back.
 - `seo-priority`: values from `1.0` to `0.1`, default: `0.5 `. Sets the `Priority` tag in the sitemap
+- `engage`: defaults to false. Hides the connection modes table and adds a note in the Destination Info box that reads "This destination is **only** compatible with [Twilio Engage](https://segment.com/docs/engage/)."

.yarn/cache/browser-sync-client-npm-2.27.11-78c81d4261-ff2b7bba6e.zip

@@ -1,29 +1,29 @@
 GIT
   remote: https://github.com/jekyll/jekyll.git
-  revision: 26a949df85a1f9577e8080e19f2196c8a3db17ec
+  revision: 58a1f62b2349bb477fc9999c40331cecdca577d8
   specs:
-    jekyll (4.2.1)
+    jekyll (4.3.2)
       addressable (~> 2.4)
       colorator (~> 1.0)
       em-websocket (~> 0.5)
       i18n (~> 1.0)
-      jekyll-sass-converter (~> 2.0)
+      jekyll-sass-converter (>= 2.0, < 4.0)
       jekyll-watch (~> 2.0)
       kramdown (~> 2.3, >= 2.3.1)
       kramdown-parser-gfm (~> 1.0)
       liquid (~> 4.0)
       mercenary (>= 0.3.6, < 0.5)
       pathutil (~> 0.9)
-      rouge (~> 3.0)
+      rouge (>= 3.0, < 5.0)
       safe_yaml (~> 1.0)
       terminal-table (>= 1.8, < 4.0)
       webrick (~> 1.7)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
+    addressable (2.8.4)
+      public_suffix (>= 2.0.2, < 6.0)
     algolia_html_extractor (2.6.4)
       json (~> 2.0)
       nokogiri (~> 1.10)
@@ -32,37 +32,23 @@ GEM
       json (>= 1.5.1)
     colorator (1.1.0)
     commonmarker (0.23.9)
-    concurrent-ruby (1.1.9)
-    dotenv (2.7.6)
-    em-websocket (0.5.2)
+    concurrent-ruby (1.2.2)
+    dotenv (2.8.1)
+    em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
-      http_parser.rb (~> 0.6.0)
+      http_parser.rb (~> 0)
     eventmachine (1.2.7)
-    faraday (1.8.0)
-      faraday-em_http (~> 1.0)
-      faraday-em_synchrony (~> 1.0)
-      faraday-excon (~> 1.1)
-      faraday-httpclient (~> 1.0.1)
-      faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.1)
-      faraday-patron (~> 1.0)
-      faraday-rack (~> 1.0)
-      multipart-post (>= 1.2, < 3)
+    faraday (2.7.5)
+      faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
-    faraday-em_http (1.0.0)
-    faraday-em_synchrony (1.0.0)
-    faraday-excon (1.1.0)
-    faraday-httpclient (1.0.1)
-    faraday-net_http (1.0.1)
-    faraday-net_http_persistent (1.2.0)
-    faraday-patron (1.0.0)
-    faraday-rack (1.0.0)
-    ffi (1.15.4)
+    faraday-net_http (3.0.2)
+    ffi (1.15.5)
     filesize (0.2.0)
     forwardable-extended (2.6.0)
-    http_parser.rb (0.6.0)
+    google-protobuf (3.23.2-x86_64-darwin)
+    http_parser.rb (0.8.0)
     httpclient (2.8.3)
-    i18n (1.8.10)
+    i18n (1.13.0)
       concurrent-ruby (~> 1.0)
     jekyll-algolia (1.7.1)
       algolia_html_extractor (~> 2.6)
@@ -73,9 +59,8 @@ GEM
       nokogiri (~> 1.6)
       progressbar (~> 1.9)
       verbal_expressions (~> 0.1.5)
-    jekyll-commonmark (1.3.1)
-      commonmarker (~> 0.14)
-      jekyll (>= 3.7, < 5.0)
+    jekyll-commonmark (1.4.0)
+      commonmarker (~> 0.22)
     jekyll-dotenv (0.2.0)
       dotenv (~> 2.7)
       jekyll (~> 4)
@@ -86,67 +71,57 @@ GEM
       posix-spawn (~> 0.3.9)
     jekyll-redirect-from (0.16.0)
       jekyll (>= 3.3, < 5.0)
-    jekyll-sass-converter (2.1.0)
-      sassc (> 2.0.1, < 3.0)
+    jekyll-sass-converter (3.0.0)
+      sass-embedded (~> 1.54)
     jekyll-sitemap (1.4.0)
       jekyll (>= 3.7, < 5.0)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
-    json (2.6.0)
-    kramdown (2.3.1)
+    json (2.6.3)
+    kramdown (2.4.0)
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
-    liquid (4.0.3)
-    listen (3.7.0)
+    liquid (4.0.4)
+    listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.4.0)
-    mini_portile2 (2.8.1)
-    multipart-post (2.1.1)
-    nokogiri (1.14.3)
-      mini_portile2 (~> 2.8.0)
-      racc (~> 1.4)
-    nokogiri (1.14.3-arm64-darwin)
-      racc (~> 1.4)
-    nokogiri (1.14.3-x86_64-darwin)
-      racc (~> 1.4)
-    nokogiri (1.14.3-x86_64-linux)
+    nokogiri (1.15.2-x86_64-darwin)
       racc (~> 1.4)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     posix-spawn (0.3.15)
     premonition (2.0.1)
-    progressbar (1.11.0)
-    public_suffix (4.0.6)
+    progressbar (1.13.0)
+    public_suffix (5.0.1)
     racc (1.6.2)
     rake (13.0.6)
-    rb-fsevent (0.11.0)
+    rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
     rexml (3.2.5)
-    rouge (3.26.1)
+    rouge (4.1.2)
     ruby2_keywords (0.0.5)
     safe_yaml (1.0.5)
-    sassc (2.4.0)
-      ffi (~> 1.9)
+    sass-embedded (1.62.1-x86_64-darwin)
+      google-protobuf (~> 3.21)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     thread_safe (0.3.6)
-    tzinfo (1.2.10)
+    tzinfo (1.2.11)
       thread_safe (~> 0.1)
-    tzinfo-data (1.2021.4)
+    tzinfo-data (1.2023.3)
       tzinfo (>= 1.0.0)
-    unicode-display_width (2.1.0)
+    unicode-display_width (2.4.2)
     verbal_expressions (0.1.5)
     wdm (0.1.1)
-    webrick (1.7.0)
+    webrick (1.8.1)
 
 PLATFORMS
-  arm64-darwin-20
   ruby
+  x86_64-darwin-19
   x86_64-darwin-20
-  x86_64-linux
 
 DEPENDENCIES
   dotenv
@@ -166,4 +141,4 @@ DEPENDENCIES
   wdm (~> 0.1.0)
 
 BUNDLED WITH
-   2.2.2
+   2.2.18