Merge branch 'develop' into update-pendo-destination-urls

Author: terence1988

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.

src/_data/catalog/destination_categories.yml

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