Skip to content

Proximal subsampling tutorial - #283

Merged
jameshadfield merged 1 commit into
masterfrom
proximal-subsampling-tutorial
Aug 18, 2026
Merged

Proximal subsampling tutorial#283
jameshadfield merged 1 commit into
masterfrom
proximal-subsampling-tutorial

Conversation

@jameshadfield

@jameshadfield jameshadfield commented Aug 17, 2026

Copy link
Copy Markdown
Member

Part of nextstrain/augur#1985

This was originally part of a nextstrain.org blogpost nextstrain/nextstrain.org#1362 but we decided to split it out into a page of its own.

This PR should be merged back-to-back with nextstrain/nextstrain.org#1362. There is a link to https://nextstrain.org/blog/2026-08-19-proximal-subsampling, this needs to be checked to ensure it's the correct datestamp.

@jameshadfield
jameshadfield force-pushed the proximal-subsampling-tutorial branch from c800d11 to c4ce9ab Compare August 17, 2026 02:08
jameshadfield added a commit to nextstrain/nextstrain.org that referenced this pull request Aug 17, 2026
Note: This originally included a tutorial which has now been moved to
docs.nextstrain.org <nextstrain/docs.nextstrain.org#283>

@joverlee521 joverlee521 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks for splitting this out! Flagged a couple small formatting issues, but overall looks good to me.

Comment thread src/tutorials/proximal-subsampling.rst Outdated
Comment thread src/tutorials/proximal-subsampling.rst Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

In the overall flow of docs, my initial thought is this fits better within or after the Filtering and Subsampling guide. However, I get that this is a common pattern that we'd like to widely surface to public health users.

Maybe a good in between is to link to the "Filtering and Subsampling" page in a "Next Steps" section so that users know where to go if they want more detail guide on subsampling. In Complex subsampling strategies, we can also link back to this tutorial for a walk-through of proximity subsampling.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yeah, I see that. I've moved it to a new page following filtering and subsampling, and added links between the two. I don't love how the how-to guides are hidden by default in the sidebar, but it is the better place for this. I've reworded things a little to call it a "how-to guide" not a "tutorial", but some usage of tutorial remains.

This was originally part of a nextstrain.org blogpost
<nextstrain/nextstrain.org#1362>
but we decided to split it out into a page of its own.

While it's written as a tutorial, it's placed in the "how-to guides"
section to fit better with our docs structure
<#283 (comment)>
@jameshadfield
jameshadfield force-pushed the proximal-subsampling-tutorial branch from c4ce9ab to b4a4cd2 Compare August 18, 2026 00:27
jameshadfield added a commit to nextstrain/nextstrain.org that referenced this pull request Aug 18, 2026
Note: This originally included a tutorial which has now been moved to
docs.nextstrain.org <nextstrain/docs.nextstrain.org#283>
as a how-to guide.

Some styling (CSS) was included to improve the rendering of the (now-removed)
tutorial; I've elected to leave it here as it generally improves blocks of
code.
@jameshadfield
jameshadfield merged commit e0b8c42 into master Aug 18, 2026
3 checks passed
@jameshadfield
jameshadfield deleted the proximal-subsampling-tutorial branch August 18, 2026 23:29
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.

2 participants