Skip to content

Create vignette - #3

Merged
Macosso merged 5 commits into
masterfrom
create_vignette
Aug 26, 2026
Merged

Macosso merged 5 commits into
masterfrom
create_vignette

Conversation

@Macosso

@Macosso Macosso commented Aug 26, 2026

Copy link
Copy Markdown
Owner

This pull request introduces documentation improvements and metadata updates for the numops R package. The main changes include adding two comprehensive vignettes that demonstrate package usage, updating the package description for clarity and accuracy, and refining the build ignore file to exclude documentation directories.

Documentation additions:

  • Added a vignette numerical-operations-in-r.Rmd that provides an overview and practical examples of all major functions in numops, covering clamping, wrapping, interpolation, remapping, division, normalization, and adjacent differences. This serves as a general introduction and reference for users.
  • Added a vignette clamp-test-wrap-numeric-values.Rmd focused on clamping, range testing, and wrapping numeric values, with detailed explanations, examples, and guidance on edge cases and workflow integration.

Metadata and build configuration:

  • Updated DESCRIPTION to clarify the package description, add vignette-related dependencies (knitr, rmarkdown), specify the vignette builder, and correct the package version and author formatting.
  • Updated .Rbuildignore to exclude doc, Meta, and docs directories from package builds, preventing unnecessary files from being included in the build artifact.

Add a new vignette demonstrating clamp, wrap, interpolation, remapping, L2 normalization, and adjacent-difference workflows. Update DESCRIPTION to include the knitr/rmarkdown vignette dependencies and enable vignette building.
Introduce a new R Markdown vignette covering the numops bounds helpers: clamp(), clamp01(), in_range(), and wrap(). It explains interval semantics, vectorization/recycling rules, missing and infinite value behavior, and practical validation/correction workflows with examples and a visualization of periodic wrapping.
Add generated documentation and package metadata directories to the ignore lists so local build artifacts like doc/, Meta/, and docs/ are not tracked or included in package builds.
This commit updates the package build metadata to match the repository layout and refreshes the release description. The .Rbuildignore file now ignores the docs directory, and the DESCRIPTION file is set back to version 1.0.0 while expanding the package summary to better describe the supported numerical operations and edge-case behavior.
Cleaned the package DESCRIPTION by removing the legacy Type field and reformatting the Authors@R entry into a compact multi-line style while preserving the same metadata and package identity.

@Macosso Macosso left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

reviewed

@Macosso
Macosso merged commit 47c25e7 into master Aug 26, 2026
5 checks passed
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.

1 participant