Skip to content

Commit

Permalink
add guidance in adapters guide
Browse files Browse the repository at this point in the history
  • Loading branch information
mirnawong1 committed Nov 20, 2023
1 parent 999b1ba commit 5ea8046
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion website/docs/guides/adapter-creation.md
Original file line number Diff line number Diff line change
Expand Up @@ -1108,7 +1108,7 @@ The following subjects need to be addressed across three pages of this docs site

| How To... | File to change within `/website/docs/` | Action | Info to Include |
|----------------------|--------------------------------------------------------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Connect | `/docs/core/connect-data-platform/{MY-DATA-PLATFORM}-setup.md` | Create | Give all information needed to define a target in `~/.dbt/profiles.yml` and get `dbt debug` to connect to the database successfully. All possible configurations should be mentioned. |
| Connect | `/docs/core/connect-data-platform/{MY-DATA-PLATFORM}-setup.md` | Create | Give all information needed to define a target in `~/.dbt/profiles.yml` and get `dbt debug` to connect to the database successfully. All possible configurations should be mentioned. |
| Configure | `reference/resource-configs/{MY-DATA-PLATFORM}-configs.md` | Create | What options and configuration specific to your data platform do users need to know? e.g. table distribution and indexing options, column_quoting policy, which incremental strategies are supported |
| Discover and Install | `docs/supported-data-platforms.md` | Modify | Is it a vendor- or community- supported adapter? How to install Python adapter package? Ideally with pip and PyPI hosted package, but can also use `git+` link to GitHub Repo |
| Add link to sidebar | `website/sidebars.js` | Modify | Add the document id to the correct location in the sidebar menu |
Expand All @@ -1123,6 +1123,14 @@ Below are some recent pull requests made by partners to document their data plat
- [SingleStore](https://github.com/dbt-labs/docs.getdbt.com/pull/1044)
- [Firebolt](https://github.com/dbt-labs/docs.getdbt.com/pull/941)

Note — Use the following re-usable component to auto-fill the frontmatter content on your new page:

```markdown
import SetUpPages from '/snippets/_setup-pages-intro.md';

<SetUpPages meta={frontMatter.meta} />
```

## Promote a new adapter

The most important thing here is recognizing that people are successful in the community when they join, first and foremost, to engage authentically.
Expand Down

0 comments on commit 5ea8046

Please sign in to comment.