Skip to content

Chapter 1 manuscript: “Background & Significance” (QMD) — initial draft for review#7

Open
Kwan-Jenny wants to merge 16 commits intomainfrom
Chapter1
Open

Chapter 1 manuscript: “Background & Significance” (QMD) — initial draft for review#7
Kwan-Jenny wants to merge 16 commits intomainfrom
Chapter1

Conversation

@Kwan-Jenny
Copy link
Copy Markdown
Collaborator

@Kwan-Jenny Kwan-Jenny commented Oct 17, 2025

What’s in this PR

  • Adds the standalone Chapter 1 manuscript as a Quarto file:
    vignettes/articles/Chapter1.qmd

  • Includes full metadata (title, abstract, affiliations), references (references_chapter1.bib), and Epidemics CSL.

  • Content covers: Overview & Significance, Immunological Foundations, Modeling Frameworks & Serodynamics, and Gaps & Rationale.

Why

  • Create a single, reviewable manuscript for advisor comments and change tracking via GitHub PR.

How to review

  • The rendered Word version (Chapter1.docx) is available on SharePoint

@codecov
Copy link
Copy Markdown

codecov bot commented Oct 17, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.

@Kwan-Jenny Kwan-Jenny changed the title # upload files Chapter 1 manuscript: “Background & Significance” (QMD) — initial draft for review Oct 17, 2025
Copy link
Copy Markdown
Member

@d-morrison d-morrison left a comment

Choose a reason for hiding this comment

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

I did a quick skim this morning; looks great!! I just made a couple of small formatting requests.

@Kwan-Jenny Kwan-Jenny removed the request for review from kaiemjoy December 16, 2025 06:33
Copy link
Copy Markdown
Member

@d-morrison d-morrison left a comment

Choose a reason for hiding this comment

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

Coming along! Some to dos to start on while I take a closer look over the next few days:

  • respond to all unresolved conversations:
image

@Kwan-Jenny
Copy link
Copy Markdown
Collaborator Author

Kwan-Jenny commented Dec 16, 2025

Coming along! Some to dos to start on while I take a closer look over the next few days:

  • respond to all unresolved conversations:
image * [x] resolve the [spellcheck errors](https://github.com/UCD-SERG/shigella/actions/runs/20259011619/job/58166839779?pr=7#step:4:117) * [x] update the docx on [sharepoint](https://ucdavis365.sharepoint.com/:w:/s/ShigellaSeroepi/ETtE13FfPRBFiIOxRjVtBFMBWVhuEyR1qHF2OXFkIRJwVA?e=t4R05O)

The rendered Word version (Chapter1.docx) and (Chapter1-Methods.docx) are available on SharePoint

@Kwan-Jenny
Copy link
Copy Markdown
Collaborator Author

Kwan-Jenny commented Dec 23, 2025

Hi @d-morrison,

The updated Word version (Chapter1.docx) is available on SharePoint

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR introduces the Chapter 1 manuscript "Modeling Antibody Kinetics Following Shigella Infection Using a Two-Phase Bayesian Hierarchical Framework" as a standalone Quarto document for advisor review and change tracking via GitHub. The manuscript provides background and significance on serodynamics modeling, covering immunological foundations, statistical frameworks, and the rationale for applying Bayesian hierarchical models to characterize Shigella antibody dynamics.

Key Changes

  • Adds a comprehensive Chapter 1 manuscript with full metadata, abstract, and references
  • Implements Quarto configuration for multi-format output (PDF, Word, HTML)
  • Includes 85 new domain-specific terms in the spell-check wordlist

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
vignettes/articles/Chapter1.qmd Main manuscript file containing background, methods, and appendices for Shigella antibody kinetics modeling
vignettes/articles/references_chapter1.bib Bibliography file with 33 references supporting the manuscript
vignettes/articles/styles/epidemics.csl Citation Style Language file for Epidemics journal formatting
vignettes/articles/Chapter1.docx Rendered Word document output (binary file)
_quarto.yml Updated Quarto configuration with bibliography, CSL, and multi-format rendering settings
inst/WORDLIST Added 85 domain-specific technical terms for spell-checking
NEWS.md Updated changelog documenting the new Chapter 1 vignette
DESCRIPTION Version bump to 0.0.0.9005 and RoxygenNote update

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

\end{cases}
$$

where $\mu$ denotes the antibody production rate during the rise phase, $\alpha$ is the decay rate, and $\rho$ controls the shape of antibody waning.
Copy link

Copilot AI Dec 23, 2025

Choose a reason for hiding this comment

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

The variable name uses Greek mu symbol (μ) inconsistently. In line 216, the rise rate parameter is defined as "mu_y", but in line 298, it's referred to as just "mu" (without the subscript y). This inconsistency should be corrected to ensure clarity - either use "mu_y" throughout or clarify the distinction between "mu" and "mu_y".

Suggested change
where $\mu$ denotes the antibody production rate during the rise phase, $\alpha$ is the decay rate, and $\rho$ controls the shape of antibody waning.
where $\mu_y$ denotes the antibody production rate during the rise phase, $\alpha$ is the decay rate, and $\rho$ controls the shape of antibody waning.

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I think I need to clarify the difference between mu and mu_y somewhere in the manuscript.

@d-morrison d-morrison removed their request for review January 2, 2026 22:11
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.

3 participants