posit::conf(2023) Workshop:Enhancing Communication & Collaboration with Quarto and Jupyter Notebooks
Register now: http://pos.it/conf Instructor: Hamel Husain Workshop Duration: 1-Day Workshop This workshop is for you if you: • have some experience with Python and Jupyter and want to learn how Quarto can support and enhance your workflows • want to learn about turning your notebooks to websites and publications • want to learn how to write python packages with Jupyter notebooks and Quarto with the help of nbdev The workshop will assume some prior experience with Python and Jupyter Notebooks. Sharing knowledge through writing is a critical aspect of scientific activity, including data science. It allows researchers to communicate their findings and insights to a wider audience, build upon existing work, and collaborate with others in their field. However, until recently, there have been limited options for publishing long-form writing and expository analyses authored in Jupyter Notebooks, a popular medium for data scientists. Enter Quarto - an innovative, open-source scientific and technical publishing system compatible with Jupyter Notebooks and other popular mediums. Quarto provides data scientists with a seamless way to publish their work in a high-quality format that is easily accessible and shareable. With Quarto, researchers can turn their Jupyter Notebooks into professional-looking publications in a variety of formats, including web pages, books, and slides. In this workshop, we will demonstrate how Quarto enables data scientists to turn their work products into professional, high-quality publications, websites, blog posts, and other shareable artifacts. As a bonus, we will also discuss how you can create and document Python packages using Jupyter notebooks and Quarto with the help of nbdev. The learning outcomes for the workshop include: • examine case studies where sharing scientific knowledge has greatly improved the efficacy of data science teams • author documents in plain text markdown or Jupyter notebooks with equations, citations, crossrefs, figure panels, callouts, and advanced layouts • learn how to author content in IPython/Jupyter and the Quarto VS Code extension • leverage Quarto for creating different types of publications, including personal blogs, knowledge management for teams, notes, books, websites, and presentation slides • extend Quarto with notebook filters and extensions • host websites and publications on platforms like GitHub Pages, QuartoPub, and Netlify • test notebooks and documentation with Quarto’s execution options • create and document Python packages with nbdev and Quarto
image: thumbnail.jpg
Transcript#
This transcript was generated automatically and may contain errors.
Hi, I'm Hemal Hussain. I have spent my entire career building developer tools for machine learning and data science. I have worked at companies like DataRobot, Airbnb, and GitHub. And through all of that experience, I've observed that the most impactful tools are ones that help you share knowledge and collaborate with your colleagues.
Specifically, tools that allow you to publish, share, and render technical reports and knowledge in a way that's easily discoverable, that other people can reference, is something that I have found, personally, through my experience, to be the highest impact type of tools that you can learn.
Specifically, tools that allow you to publish, share, and render technical reports and knowledge in a way that's easily discoverable, that other people can reference, is something that I have found, personally, through my experience, to be the highest impact type of tools that you can learn.
And that's why I'm really excited to teach this course on Enhancing Communication & Collaboration with Jupyter Notebooks and Quarto.
Why Jupyter Notebooks and Quarto
So as you may know, Jupyter Notebooks is a great medium in which to write technical information. You can intersperse code and prose in a natural way without having to copy and paste code from another context. You can have inline charts and interactive widgets and all kinds of things that really enhance the presentation of technical material.
However, how do you go from this rich environment of a notebook to publishable content, something like a website or a blog post, or even an internal knowledge management system where if you're working on a team of data scientists, you can collaborate and look at each other's work and search each other's work. And this is something that Quarto really excels at.
What this course covers
And this is what I want to teach in this course. So in this course, I'm going to show you how you can author documents in both Jupyter Notebooks but also in plain text markdown files. I'll also show you how you can use VS Code and the Quarto VS Code extension to aid you in creating Quarto projects and editing files.
I'm going to show you how you can leverage Quarto to create different types of publications such as personal blogs, knowledge management, platforms for teams, notes, books, websites, and even presentation slides. These are all formats that I have produced myself with Quarto.
I'm going to also show you how you can extend Quarto with notebook filters and extensions. I'm also going to show you how you can host websites and publications on platforms like GitHub Pages, Quarto Pub, and Netlify. I'm also going to show you how you can test your notebooks and test your documentation so that you can be sure that the code is valid and correct and is not stale.
And as a bonus, I'm going to also teach how you can even create and document Python packages with a tool called NBDev and Quarto. I am a core developer on NBDev and NBDev is built on Quarto and is one of the sources of my knowledge of Quarto and one of the reasons why I am excited about it.
I hope that you'll join me in this course. I think it has a lot of value for both personal growth in terms of helping you write blog posts and share information, but also is a great tool to help you up-level your teams. Thank you.
