Given the renaming of the bar plots file, it has become apparent that regular edits to the table of contents (TOC) will be necessary for each publication on the GH pages to ensure that the links on the Index page correctly point to the corresponding posts.

As a result, this Issue will require ongoing attention throughout the duration of the project.

Tasks:

• Confirm that the relevant .ipynb and .html files have been added to the repository.
• Rewrite, if necessary, the TOC to match the file names
• Add the .html file as a link to Index.html

Checklists:

INTRODUCTION POST

• Is the topic on the TOC
• Does it have a functional link in the Index.html file

BAR PLOTS

• Is the topic on the TOC
• Does it have a functional link in the Index.html file

DOT PLOTS AND HEATMAP

• Is the topic on the TOC
• Does it have a functional link in the Index.html file

SINGLE DISTRIBUTION HISTOGRAM AND DENSITY PLOT

• Is the topic on the TOC
• Does it have a functional link in the index.html file

MULTIPLE DISTRIBUTION HISTOGRAM AND DENSITY PLOT

• Is the topic on the TOC
• Does it have a functional link in the index.html file

BOXPLOTS AND RIDGELINE PLOTS

• Is the topic on the TOC
• Does it have a functional link in the index.html file

SCATTER PLOTS AND CORRELOGRAMS

• Is the topic on the TOC
• Does it have a functional link in the index.html file

GEOSPATIAL DATA

• Is the topic on the TOC
• Does it have a functional link in the index.html file

I see https://github.com/hnguyentt/dataviz-python/issues/1#issue-1753060960 -- we can credit them if they allow us to use the work. Otherwise, we can write a script to do this ourselves and add some notes in our README.

Topics to cover: Bar plots

Link to WIP blog post: Google doc

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible
• Does the notebook text and blog post text follow our docs style guide
• Do all images have alt-text?

We have https://github.com/bokeh/dataviz-fundamentals/blob/main/data/rda_files/convert_to_csv.py that creates csv files from the original rda format data. We can move this to a separate folder called scripts at the top level to have a cleaner dir strcuture.

Note that we'll also need to update some paths in the script itself if we do this.

Topics to cover: Dot plots and heatmaps

Link to WIP blog post: https://docs.google.com/document/d/1XdiTYfAET07bYwqf1CDYFVaKNXwFbTqK4cnrmzCjJis/edit?usp=sharing

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible
• Does the notebook text and blog post text follow our docs style guide
• Do all images have alt-text?

Topics to cover: Cartograms

Link to WIP blog post: incoming

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible
• Does the notebook text and blog post text follow our docs style guide
• Do all images have alt-text?

Topics to cover: Box plots and Ridgeline plots

Link to WIP blog post: https://docs.google.com/document/d/1j5kWKjeV96UbpYVOJaX5mepgT4Q2u8lfvuqyfjW8GaA/edit#heading=h.v1jrx5yh7r2g

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible
• Does the notebook text and blog post text follow our docs style guide
• Do all images have alt-text?

Topics to cover: Scatter plots and Correlograms

Link to WIP blog post: https://docs.google.com/document/d/1t4cl4CksqotxP3H0RhbSk4bRvaixBl2v_XaJyhZ2O9Y/edit

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible
• Does the notebook text and blog post text follow our docs style guide
• Do all images have alt-text?

We may be able to write/find a github action to do this?

Note: This needs more investigation, just noting to capture this.

Topics to cover: Multiple distribution histogram and density plot

Link to WIP blog post: https://docs.google.com/document/d/1WF2mB_NKIDymBIi8TfHXtPsAAH_3CNKDh0sgjA649Ls/edit

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible
• Does the notebook text and blog post text follow our docs style guide
• Do all images have alt-text?

The Introduction.ipynb and Introduction.html files till contain the old file paths. I have to modify them to refelct the new file paths and also reflect the style guide for subsequent posts.

Topics to cover: Grouped and stacked bar plots

Link to WIP blog post: (https://docs.google.com/document/d/17X5aWqkB9FvZHICdPxuTCBfXrbidU25H9_2JuFdXz3c/edit)

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible?
• Does the notebook text and blog post text follow our docs style guide?
• Do all images have alt-text?

• Introduction blog post submitted on Medium
• README file updated with the current Table of Contents (WIP)
• Index page created on the GH page with links in the Table of contents
• Introduction plot made and linked in the GH page
• Blog post published on Medium

Open new issues (for example #3) to track each notebook (and corresponding blog post), which can have subtasks for activities like data preparation.

This is a meta issue to ensure we complete the project management bits.

Topics to cover: Single distribution histogram and density plot

Link to WIP blog post: https://docs.google.com/document/d/1awwo3u5jDmOQ2tN9ftr1BXpJiaAzOpx-W0yT8c2mgs8/edit

Checklist:

Tasks:

• Notebook created
• Blog post created
• Notebook rendered on GitHub pages
• Blog post published
• Social media announcements

Checks:

• Is the notebook reproducible
• Does the notebook text and blog post text follow our docs style guide
• Do all images have alt-text?

Add the following to the project readme:

• Project description
• Table of contents, with one-line descriptions for each notebook
• Local setup instructions
• Contributing/developer guidelines
• License & CoC note

The Github pages deployed from the /docs directory needs a theme.

PROBLEM DESCRIPTION

I am facing challenges with the way my Pull Requests (PRs) are being created.

ISSUE DETAILS

Typically, when I create a PR in a new branch, I notice that all the commits from other unmerged PRs in different branches are also included. For instance, PR #14 was intended to include only the specific named commit, but it also contained unmerged commits from my main, intro, and bar-plot branches, which I did not intend to include. This makes the PR look disorganised.

WHAT I HAVE TRIED

I have attempted to create a new branch and use git cherry-pick to select only the desired commit to push from that branch. However, this approach has not been successful. I have also tried various suggestions found online, but none of them have resolved the issue. The resulting PRs still include other commits not associated with the specific branch.

WHAT I NEED

I need a straightforward method to create PRs with only a single commit, even in cases where there may be unmerged commits from other branches.