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

Add documentation project #61

Merged
merged 15 commits into from
Apr 7, 2023
Merged

Add documentation project #61

merged 15 commits into from
Apr 7, 2023

Conversation

ian-r-rose
Copy link
Member

Fixes #58. Depends on #57. See the built version here.

This uses mkdocs-material as a lightweight static site generator. We could also use sphinx, mdbook, docasaurus, etc for this, but mkdocs was exceedingly simple to set up.

Follow-ups would include adding dbt docs to this (which depends on #46)

Copy link
Contributor

@britt-allen britt-allen left a comment

Choose a reason for hiding this comment

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

This is a supremely great start! Thank you Ian. I'll see if I can fit my docs in here too.

@britt-allen
Copy link
Contributor

Please let me know what else you add/change when this is no longer a draft if not obvious via the GH ui. @ian-r-rose

@ian-r-rose
Copy link
Member Author

ian-r-rose commented Apr 7, 2023

Please let me know what else you add/change when this is no longer a draft if not obvious via the GH ui. @ian-r-rose

Thanks! I just had it as a draft until #57 was merged. Now that it's in, this PR should be easier to review, since the changes in it are only documentation-related.

@ian-r-rose ian-r-rose marked this pull request as ready for review April 7, 2023 22:44
@@ -20,7 +22,7 @@ The process for GitHub-based development is:
1. In general, the author of a PR should not approve and merge their own pull request.
1. Delete your feature branch, it's in `main` now.

## Authoring a pull request
## Considerations when authoring a pull request

#### Have Empathy
Copy link
Contributor

Choose a reason for hiding this comment

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

:')

small punctuation and sentence flow edits
small stylistic and punctuations edits
Copy link
Contributor

Choose a reason for hiding this comment

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

This was an excellent read! I learned so much

changed position of "analytics engineering" to practice and position of "analytics engineering"
Copy link
Contributor

@britt-allen britt-allen left a comment

Choose a reason for hiding this comment

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

Looks great, thanks Ian!

@britt-allen britt-allen merged commit 50bd16e into main Apr 7, 2023
ian-r-rose pushed a commit that referenced this pull request Apr 10, 2023
Add documentation project
@ian-r-rose ian-r-rose deleted the mkdocs branch April 11, 2023 20:15
@ian-r-rose ian-r-rose mentioned this pull request Apr 11, 2023
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.

Pattern for publishing docs
2 participants