About this template
File location: | /_templates/destinations/base-docs/version |
Used in: | |
Repo link: | Click to view in the Stitch Docs repo |
Instructions: |
This template is used to add destination setup documentation to the Stitch Docs. This template is used to add destination setup documentation to the Stitch Docs.
Template sections
Each template is grouped into sections to make parameters easier to find. These sections and the parameters they contain are described below.
- Page and formatting
- Destination details
- Setup instructions: Requirements
- Content section types
- Content sections
Page and formatting
These parameters control the layout and formatting used on the page.
Parameter | Description |
title STRING |
The title of the page. Example values:
|
permalink STRING |
The page’s permalink value, used to generate its final URL. Example values:
|
keywords STRING |
Relevant keywords that could be used to search for the doc in a search engine. |
content-type STRING |
The type of content the page contains. This will be |
key STRING |
A semi-unique ID for this page of the destination’s documentation set. This controls the links that display in the version menu. Only files with this key will be included as links in the version menu. This value should be formatted as: Example values:
|
order INTEGER |
The order this page should display in the list of Getting Started guides for the destination. Example Example values:
|
toc BOOLEAN |
If |
layout STRING |
The layout the page will use. This should be |
use-tutorial-sidebar BOOLEAN |
If |
Destination details
High-level details about the destination, including pricing notes, its release status, features, etc.
Parameter | Description |
display_name STRING |
The display name of the destination. The destination’s name should match how the provider uses it, including capitalization, punctuation, etc. Example values:
|
name STRING |
The name of the destination, in lowercase. Example values:
|
type STRING |
The name of the destination, in lowercase. This is used to associate variants of a destination to their parent. For example: Amazon Aurora PostgreSQL destinations are based on Stitch’s PostgreSQL destination, or To correctly associate variants to a parent destination type, this value must match the Example values:
|
setup-name STRING |
The display name of the destination in Stitch that should be used to connect the destination. For example: While Stitch’s PostgreSQL destination supports connecting to an Amazon Aurora PostgreSQL database, there isn’t a branded destination in Stitch for Amazon Aurora. To connect an Amazon Aurora PostgreSQL database as a destination, users should use the Note: This property only needs to be used if the guide is for a variant of a destination. Example values:
|
hosting-type STRING |
If the destination is cloud-based, the name of the provider, in lowercase. This is used to:
Example values:
|
ssh BOOLEAN |
If |
ssl BOOLEAN |
If |
api-type STRING |
The name of the API connection property object that corresponds to the destination. For example: Amazon Redshift destinations correspond to the |
this-version STRING |
The version of the destination. This value should be an integer. Example values:
|
Setup instructions: Requirements
The requirements for setting up and successfully connecting an integration to Stitch.
Parameter | Description |
requirements ARRAY |
The prerequisites for setting up the integration in Stitch. Markdown may be used to write the content in this field. If needed, HTML will also work. This is formatted as a list, with an
|
Content section types
The instructions for setting up the destination in Stitch.
Parameter | Description |
steps ARRAY |
An array of content sections which contain the instructions for setting up the destination in Stitch. The content in these sections creates the setup steps in the finished doc. |
Content sections
Each content section type takes the parameters listed below, which Jekyll then parses and renders into content. Formatting is the same regardless of the content section type being used:
{content-section-type}:
- title: "Select an attribution window"
anchor: "select-attribution-window"
content: |
Do a thing
Using the appropriate layout (Page and formatting, layout
), Jekyll will then render the following output:
<h2 id="select-attribution-window">
Step #: Select an attribution window
</h2>
<p>Do a thing</p>
Parameter | Description |
title STRING |
The title of the section. Example values:
|
anchor STRING |
The value to be used as the anchor for section’s title. For example: |
content STRING |
The section content. Markdown may be used to write the content in this field. If needed, HTML will also work. Additionally, note that:
|
substeps ARRAY |
For setup instructions ( For example:
|
Back to top
Last updated: 28 July 2021