Skip to content

Commit

Permalink
updating to current
Browse files Browse the repository at this point in the history
  • Loading branch information
runleonarun committed Nov 2, 2022
2 parents 4220d49 + 5feabae commit b3ddf25
Show file tree
Hide file tree
Showing 879 changed files with 26,521 additions and 14,425 deletions.
10 changes: 6 additions & 4 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Lower entries on this list take precedence

# Anything unmatched by selectors below
* @annafil @runleonarun
* @runleonarun

# Cloud docs and images are assigned to Leona
/website/docs/docs/dbt-cloud/dbt-cloud-changelog.md @runleonarun
Expand All @@ -10,16 +10,18 @@
/website/static/img/docs/dbt-cloud/ @runleonarun

# Blog content assigned to Developer experience team
/website/blog/ @KiraFuruichi @dbt-labs/devhub
/website/blog/ @runleonarun



# Adapter & Package Development Docs
/website/docs/docs/available-adapters.md/ @runleonarun @dataders
/website/docs/docs/supported-data-platforms.md/ @runleonarun @dataders
/website/docs/reference/warehouse-profiles/ @runleonarun @dataders
/website/docs/reference/resource-configs/ @runleonarun @dataders
/website/docs/guides/building-packages @runleonarun @amychen1776 @dataders @dbeatty10
/website/docs/guides/building-packages @runleonarun @amychen1776 @dataders @dbeatty10
/website/docs/contributing/building-a-new-adapter @runleonarun @dataders @dbeatty10
/website/docs/contributing/testing-a-new-adapter @runleonarun @dataders @dbeatty10
/website/docs/guides/creating-new-materializations @runleonarun @dataders @dbeatty10
/website/docs/docs/dbt-cloud/cloud-configuring-dbt-cloud/ @runleonarun @dataders @dbeatty10


3 changes: 3 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
<!---
Describe your changes, and why you're making them. Is this linked to an open
issue, a pull request on dbt core, etc?
To learn more about the writing conventions used in the dbt Labs docs, see the [Content style guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md).
-->

## To-do before merge
Expand All @@ -25,3 +27,4 @@ If you added new pages (delete if not applicable):
If you removed existing pages (delete if not applicable):
- [ ] The page has been removed from `website/sidebars.js`
- [ ] An entry has been added to `_redirects`
- [ ] [Run link testing](https://github.com/dbt-labs/docs.getdbt.com#running-the-cypress-tests-locally) to update the links that point to the deleted page
7 changes: 7 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,10 @@ website/build/
website/yarn.lock
website/node_modules
website/i18n/*

# Local vs code
.vscode
# Local Netlify folder
.netlify

.vscode
9 changes: 9 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"spellright.language": [
"en"
],
"spellright.documentTypes": [
"latex",
"plaintext"
]
}
66 changes: 34 additions & 32 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,70 +1,72 @@
_We use [docusaurus](https://v2.docusaurus.io/) to power [docs.getdbt.com](https://docs.getdbt.com/)._

#### Table of Contents

* [Code of Conduct](#Code-of-conduct)
* [Contributing](#contributing)
* [Writing content](#writing-content)
* [Running the docs site locally](#running-the-docs-site-locally)

# Code of conduct

Please review the dbt docs contributors [code of conduct](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/contributor-code-of-conduct.md).
Creating an inclusive and equitable environment for our documents is more important than any other aspect. Syntax errors can be corrected, but trust, once lost, is difficult to gain back.

# Contributing

We welcome contributions from community members to this repo:
- **Fixes**: When you notice an error, you can use the `Edit this page` button at the bottom of each page to suggest a change.
- **Fixes**: When you notice an error, you can use the `Edit this page` button at the bottom of each page to suggest a change.
- **New documentation**: If you contributed code in [dbt-core](https://github.com/dbt-labs/dbt-core), we encourage you to also write the docs here! Please reach out in the dbt community if you need help finding a place for these docs.
- **Major rewrites**: You can [file an issue](https://github.com/dbt-labs/docs.getdbt.com/issues/new?assignees=&labels=content%2Cimprovement&template=improve-docs.yml) or [start a discussion](https://github.com/dbt-labs/docs.getdbt.com/discussions) to propose ideas for a content area that requires attention.

You can use components documented in the [docusaurus library](https://v2.docusaurus.io/docs/markdown-features/).
You can use components documented in the [docusaurus library](https://v2.docusaurus.io/docs/markdown-features/).

# Writing content

When writing content, you should refer to the style guide (TBD) and [content types](/contributing/content-types.md) to help you understand our writing standards and how we break down information in the product documentaion.

## Using the content style guide

[TBD] a style guide to help you write in a consistent, accessible, and inclusive style.
When writing content, you should refer to the [style guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md) and [content types](/contributing/content-types.md) to help you understand our writing standards and how we break down information in the product documentation.

## Versioning content
## Versioning and single-sourcing content

We now provide dynamic versioning in the dbt Labs product documentation. To learn more about how to version the docs for dbt Core, see [Managing available versions](/contributing/versioningdocs.md).
We now enable you to reuse content between different docs pages, version pages, and establish product variables in the dbt Labs product documentation. To learn more about how to single source content between versions, product variables, and other content, see [Single-sourcing content](/contributing/single-sourcing-content.md).

## Adding content to the glossary
## Adding tabbed components to a page

[TBD] a how-to guide on the programming behind glossary entries.
You can add code snippets and other content in a tabbed view. To learn more about adding tabbed components, see [Adding page components](/contributing/adding-page-components.md).

# Running the Docs site locally

You can click a link available in a netlify bot PR comment to see and review your changes rendered on a staging server. You are also able to see and review your proposed modifications locally on your computer. Our setup instructions use [homebrew](https://brew.sh/):

## prerequisites
* Install [Xcode Command Line Tools](https://developer.apple.com/download/more/); you'll likely need an AppleID for this.
* Install [homebrew](https://brew.sh/).
## Prerequisites

1. Install `node`: `brew install node`
2. Clone this repo: `git clone [email protected]:dbt-labs/docs.getdbt.com.git`
* (Mac Terminal) Install [Xcode Command Line Tools](https://developer.apple.com/download/more/)
- Open a terminal window, run `xcode-select --install`, and follow the on-screen prompts in the pop-up window.
* (Mac and Linux) Install [homebrew](https://brew.sh/)
- Copy and paste `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` in to a terminal window and follow the prompts. Once the installation has completed, follow the **Next Steps** instructions listed in terminal.
* (Windows) Install [Node.js](https://nodejs.org/en/download/)

1. (Mac and Linux only) Install `node`: `brew install node`
2. Clone this repo: `git clone https://github.com/dbt-labs/docs.getdbt.com.git`
3. `cd` into the repo: `cd docs.getdbt.com`
4. `cd` into the `website` subdirectory: `cd website`
5. Install the required node packages: `npm install`
5. Install the required node packages: `npm install` (optional &mdash; install any updates)
6. Build the website: `npm start`
7. Before pushing your changes to a branch, check that all links work by using the `make build` script.

Advisory:
- Currently an `npm install` produces a number of dependency warnings, in particular several claiming that `docusaurus/core` is missing. Rest assured, this message is a red herring. As of writing this, no 2.0.0 package exists, so you won't have much luck trying to install it. Feel free to ignore those warnings.
Advisory:
- If you run into an `fatal error: 'vips/vips8' file not found` error when you run `npm install`, you may need to run `brew install vips`. Warning: this one will take a while -- go ahead and grab some coffee!

## Running the Cypress tests locally

Method 1: Utilizing the Cypress GUI
1. Install `node`: `brew install node`
2. Clone this repo: `git clone [email protected]:dbt-labs/docs.getdbt.com.git`
3. `cd` into the repo: `cd docs.getdbt.com`
4. `cd` into the `website` subdirectory: `cd website`
5. Install the required node packages: `npm install`
6. Run `npx cypress open` to open the Cypress GUI, and choose `E2E Testing` as the Testing Type, before finally selecting your browser and clicking `Start E2E testing in {broswer}`
7. Click on a test and watch it run!
1. `cd` into the repo: `cd docs.getdbt.com`
2. `cd` into the `website` subdirectory: `cd website`
3. Install the required node packages: `npm install`
4. Run `npx cypress open` to open the Cypress GUI, and choose `E2E Testing` as the Testing Type, before finally selecting your browser and clicking `Start E2E testing in {broswer}`
5. Click on a test and watch it run!

Method 2: Running the Cypress E2E tests headlessly
1. Install `node`: `brew install node`
2. Clone this repo: `git clone [email protected]:dbt-labs/docs.getdbt.com.git`
3. `cd` into the repo: `cd docs.getdbt.com`
4. `cd` into the `website` subdirectory: `cd website`
5. Install the required node packages: `npm install`
6. Run `npx cypress run`
1. `cd` into the repo: `cd docs.getdbt.com`
2. `cd` into the `website` subdirectory: `cd website`
3. Install the required node packages: `npm install`
4. Run `npx cypress run`
Loading

0 comments on commit b3ddf25

Please sign in to comment.