Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs improvements #115

Merged
merged 32 commits into from
Sep 5, 2023
Merged

Docs improvements #115

merged 32 commits into from
Sep 5, 2023

Conversation

graciegoheen
Copy link
Collaborator

@graciegoheen graciegoheen commented Aug 16, 2023

Ran into a few bugs while I was creating these docs. Will need to update the docs one the bugs are resolved.

docs/index.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
@graciegoheen graciegoheen marked this pull request as ready for review August 18, 2023 21:53
Copy link
Collaborator

@dave-connors-3 dave-connors-3 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

small comments and follow ups! looks awesome, thanks for spending the time on this!

docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
# optionally use the add-version operation to add a new version to a model
dbt-meshify operation add-version -s fct_orders
```
## What dbt-meshify does not handle
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dave-connors-3 @nicholasyager would love to get your thoughts on if anything else should be called out here!

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤔 Some low risk thoughts

  • split doesn't copy over all project files, so there may be documentation that's not copied over (like markdown files).
    • Now that I'm thinking about it, does split copy over files with docblocks?
  • group and create-group will update existing groups already defined in yml.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What would be the manual checks for these?

@graciegoheen
Copy link
Collaborator Author

Note to self: should update the size of some of these images (some are giant)

Copy link
Collaborator

@nicholasyager nicholasyager left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@graciegoheen This documentation is WAAAAAY better than what currently exists. I've added a couple of recommendations and followed up on threads. Otherwise, no issues as far as I can see!

docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/examples.md Show resolved Hide resolved
docs/examples.md Show resolved Hide resolved
docs/examples.md Show resolved Hide resolved
docs/examples.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
# optionally use the add-version operation to add a new version to a model
dbt-meshify operation add-version -s fct_orders
```
## What dbt-meshify does not handle
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤔 Some low risk thoughts

  • split doesn't copy over all project files, so there may be documentation that's not copied over (like markdown files).
    • Now that I'm thinking about it, does split copy over files with docblocks?
  • group and create-group will update existing groups already defined in yml.

Co-authored-by: Nicholas A. Yager <[email protected]>
@dave-connors-3 dave-connors-3 merged commit e7438b8 into main Sep 5, 2023
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants