Skip to content

Improve package documentation, structure, and pkgdown site - #28

Merged
olivieradjagba merged 9 commits into
mainfrom
dev
Jul 22, 2026
Merged

Improve package documentation, structure, and pkgdown site#28
olivieradjagba merged 9 commits into
mainfrom
dev

Conversation

@olivieradjagba

@olivieradjagba olivieradjagba commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Description

This PR updates the package following version 0.2.2, with a focus on documentation, consistency, and release maintenance.

The main changes are:

  • Add and configure the pkgdown documentation website and deployment workflow.
  • Reorganize and rename vignettes for clearer website navigation.
  • Move vignette illustrations and add responsive figure styling.
  • Improve methodological guidance, examples, and data-requirement documentation.
  • Clarify the distinction between empirical intervals across imputation samples and confidence intervals for the mean.
  • Update plots to display empirical quantiles across imputation samples.
  • Clarify vaccine-uptake overlap assumptions and the provenance of the bundled efficacy estimates.
  • Clarify function arguments, return values, dataset structures, and validation requirements.
  • Improve package metadata, including authors and repository links.
  • Mark internal functions so they do not appear in the public pkgdown reference.
  • Change the separator used for generated multi-column administrative identifiers from __ to :::.
  • Standardize R source, test, and snapshot filenames.
  • Regenerate the package’s Rd documentation using the updated roxygen2 version.
  • Add a reusable GitHub release-notes template.

Migration note

Generated administrative identifiers that previously used __ now use :::. Code or stored data that creates, compares, or parses these identifiers must be updated accordingly.

Related issues

None.

Type of change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update
  • Code refactoring
  • Performance improvement

Checklist

  • I have read the contributing guidelines
  • My code follows the package style guide
  • I have added/updated tests
  • I have updated documentation
  • All checks pass locally (devtools::check())
  • I have added a NEWS entry (if applicable)

DESCRIPTION:
- Add additional authors
- Correct repository and bug-reporting URLs

DOCUMENTATION:
- Move illustrations folder from inst/ to vignettes/
- Add custom CSS for figure styling
- Switch from knitr R-style figure generation to markdown syntax
- Ensure responsive images with max-width: 750px and centered alignment
- Add pkgdown configuration with _pkgdown.yml
- Set up documentation website structure and theme
- Update roxygen2 to version 8.0.0 in DESCRIPTION
- Re-document all functions with latest roxygen2
- Rename vignettes for better pkgdown navigation:
  - `get-started` → `pviem` (enables "Get started" navbar entry)
  - `data-requirements` → `data` (simplified naming)
- Minor content and formatting improvements to vignettes
Add missing @Keywords internal tags to internal functions so they no longer
appear in the pkgdown reference page.
- standardize R source and test filenames
- clarify API, return-value, and dataset documentation
- improve package metadata and vignette configuration
- fix minor style and documentation issues
- regenerate Rd reference files
- distinguish empirical intervals from confidence intervals
- update plots to show quantiles across imputation samples
- clarify rho assumptions for overlapping vaccine uptake
- improve data requirements and efficacy provenance notes
- refine README and vignette navigation
@olivieradjagba olivieradjagba changed the title Dev Improve package documentation, structure, and pkgdown site Jul 22, 2026
@olivieradjagba olivieradjagba self-assigned this Jul 22, 2026
@olivieradjagba olivieradjagba added documentation Improvements or additions to documentation tests labels Jul 22, 2026
Rename snapshot files to match the hyphenated test filenames.
- change the administrative identifier separator from `__` to `:::`
- update documentation and snapshots for the new separator
- apply minor assignment-style cleanup
- add a GitHub release notes template
@olivieradjagba
olivieradjagba marked this pull request as ready for review July 22, 2026 14:36
@olivieradjagba
olivieradjagba merged commit 6649b31 into main Jul 22, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant