Skip to content

docs: add index page and related stuff for jupyter tutorials#13342

Merged
vtlim merged 9 commits intoapache:masterfrom
317brian:jupyter-nb-api-tutorial
Dec 16, 2022
Merged

docs: add index page and related stuff for jupyter tutorials#13342
vtlim merged 9 commits intoapache:masterfrom
317brian:jupyter-nb-api-tutorial

Conversation

@317brian
Copy link
Copy Markdown
Contributor

@317brian 317brian commented Nov 9, 2022

  • Adds docs/tutorials/tutorial-jupyter-index.md as a landing page for the Jupyter notebook tutorials
  • Updates sidebars.json to include the landing page
  • Updates .gitignore to ignore the Jupyter checkpoint saves
  • Adds examples/quickstart/jupyter-notebook
    • Adds a readme that has the same content as tutorial-jupyter-index.md as well as some basic info about contributing
    • Adds the Jupyter notebook file api-tutorial.ipynb

Note that the download links will 404 until this PR is merged into master since they reference the raw GitHub URL on master, which is the easiest way for a user to download a single notebook from what I found based on where we decided to put it.

We can test the download link by either manually inserting a different file that already exists or splitting this PR into 2 and merging the notebook first. This is the link from it being merged into my fork https://raw.githubusercontent.com/317brian/druid/master/examples/quickstart/jupyter-notebooks/api-tutorial.ipynb

This PR has:

  • been self-reviewed.

@317brian
Copy link
Copy Markdown
Contributor Author

If we want to take the 2 PR approach, #13345 contains only the notebook file and .gitignore. If that one gets approved/merged, the download link in this one should work.

@317brian 317brian changed the title docs: add tutorial for the Druid API that uses Jupyter notebook docs: add index page and related stuff for jupyter tutorials Dec 12, 2022
Copy link
Copy Markdown
Contributor

@techdocsmith techdocsmith left a comment

Choose a reason for hiding this comment

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

LGTM

@vtlim vtlim merged commit d9c27d6 into apache:master Dec 16, 2022
vtlim pushed a commit to vtlim/druid that referenced this pull request Dec 16, 2022
@kfaraz kfaraz added this to the 25.0 milestone Dec 17, 2022
kfaraz pushed a commit that referenced this pull request Dec 17, 2022
* docs: add index page and related stuff for jupyter tutorials (#13342)

* docs: notebook only for API tutorial (#13345)

* docs: notebook for API tutorial

* Apply suggestions from code review

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

* address the other comments

* typo

* add commentary to outputs

* address feedback from will

* delete unnecessary comment

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

Co-authored-by: 317brian <53799971+317brian@users.noreply.github.com>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants