Merge branch 'develop' into dineshraj-arunmozhi-patch-2

Author: stayseesong

CODEOWNERS

@@ -41,10 +41,10 @@ CODEOWNERS  @segmentio/segment-doc-team
 
 
 # Engage
-/src/engage/ @pwseg @rchinn-segment
+/src/engage/ @pwseg 
 
 # Unify
-/src/unify @rchinn-segment
+/src/unify @pwseg 
 
 # Protocols owners
 /src/protocols @forstisabella

CONTRIBUTING.md

@@ -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.

README.md

@@ -11,11 +11,25 @@ This repository contains the documentation website code and source files for htt
 
 In this article, find information about:
 
+- Prerequisites
 - Contributing
 - A list of READMEs
 - Code of conduct
 - License agreement
 
+## Prerequisites 
+The following are a list of prerequisites you may want to consider downloading and installing to successfully contribute to the Segment docs repo:
+
+1. Download and install a source code editor like [Visual Studio Code](https://code.visualstudio.com/download). 
+1. Download and install a package manager such as [Homebrew](https://brew.sh/) to install new software.
+1. [Create an account on GitHub](https://docs.github.com/en/get-started/quickstart/creating-an-account-on-github) if you don't have one already, or sign in with your existing GitHub account.
+1. Add the GitHub extension to your editor (in VSC: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github).
+1. [Clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) the Segment docs repo.
+1. Download and install the latest version of [node.js](https://nodejs.org/en/download). Consider using a version manager such as [ASDF](https://github.com/asdf-vm/asdf) or [nvm-windows](https://docs.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows).
+1. Install dependencies 
+  `npm i`
+1. Install [vale](https://docs.errata.ai/vale/install). An [ASDF plugin](https://github.com/osg/asdf-vale) is also available.
+
 ## Contributing
 
 The Segment docs team accepts contributions in the form of issues and pull requests.

scripts/catalog/updateDestinations.js

@@ -102,10 +102,11 @@ const updateDestinations = async () => {
         return clonedObj;
       };
 
-      // I honestly don't remember why I did this.
-      // I think someone wanted to mention support for the Screen method to whatever destination that is
+      // The screen method is not returned as a method from the public API, so if a destination wants to 
+      // show screen as a supported method in `destination-dossier.html` then add the destination id here
+      const destinationsThatSupportScreen = ['63e42b47479274407b671071', '65ccc6147108efc0cf5c6fe1']
       destination.supportedMethods.screen = false;
-      if (destination.id == '63e42b47479274407b671071') {
+      if (destinationsThatSupportScreen.includes(destination.id)) {
         destination.supportedMethods.screen = true;
       }
 

src/_data/catalog/beta_sources.yml

@@ -21,4 +21,6 @@
 - o9OyD6xsVJ
 - ODf0vA6dcH
 - YWOGVbyMVz
-- CwGEZ7eCcA
+- CwGEZ7eCcA
+- xeZMgSrtAQ
+- VShGHAfvlr

src/_data/catalog/destination_categories.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
-# destination categories last updated 2024-01-04 
+# destination categories last updated 2024-03-05 
 items:
 - display_name: A/B Testing
   slug: a-b-testing