Documentation & Version Control Flashcards

After a merge conflict appears in a model's .sql file, what is the correct next step?

Answer: Edit the file to remove conflict markers, then commit the resolution

Conflicts must be resolved manually by editing the markers and committing the result.

To undo a bad commit already pushed to a shared branch, which is safest?

Answer: git revert to create an inverse commit

git revert preserves history, so collaborators are not left with divergent histories.

Where does a dbt Cloud CI job build models for a pull request?

Answer: A temporary schema unique to that PR

CI jobs create a temporary schema named for the PR so production is untouched.

How do you pin a hub package to a compatible range in packages.yml?

Answer: version: [">=1.0.0", "<2.0.0"]

Hub packages accept a version key that can be a string or a list defining a range.

Which property declares multiple versions of a model in YAML?

Answer: versions:

The versions property, with latest_version and optional defined_in, supports model versioning.

How can you document a macro and its arguments?

Answer: Add a macros: entry in a YAML file with description and arguments

Macro properties files support description and arguments entries displayed in the docs.

Which dbt Cloud job setting keeps the docs site current after production runs?

Answer: Generate docs on run

Enabling generate docs on run makes the job refresh docs artifacts for the hosted docs site.