poplindata / dbt-docs

Auto-generated data documentation site for dbt projects

dbt docs

dbt (data build tool) helps analysts write reliable, modular code using a workflow that closely mirrors software development.

This repository contains code for generating a documentation site for dbt projects. Check out the dbt documentation for more information.

---

Getting Started

• What is dbt?
• Read the dbt viewpoint
• Installation
• Join the chat on Slack for live questions and support.

Code of Conduct

Everyone interacting in the dbt project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PyPA Code of Conduct.

Development

After cloning this repository, run:

git submodule update --init --recursive

You'll also need to install bundler if you don't already have it:

gem install bundler
bundle install

Build / Run

To build the css files required for webpack:

cd styles
bundle exec jekyll build
cd -

To build an index.html file:

npm install
npx webpack

To run the dev server, first copy your manifest.json and catalog.json files to the src/ directory. Then run:

npm install
npm start