Add REFERENCES.bib and update README.Rmd with paper reference and example

Co-authored-by: osorensen <21175639+osorensen@users.noreply.github.com>

Author: Copilot

README.Rmd

@@ -1,5 +1,6 @@
 ---
 output: github_document
+bibliography: inst/REFERENCES.bib
 ---
 
 <!-- README.md is generated from README.Rmd. Please edit that file -->
@@ -19,7 +20,7 @@ knitr::opts_chunk$set(
 [![R-CMD-check](https://github.com/osorensen/BayesMallowsSMC2/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/osorensen/BayesMallowsSMC2/actions/workflows/R-CMD-check.yaml)
 <!-- badges: end -->
 
-BayesMallowsSMC2 provides functions for performing sequential inference in the Bayesian Mallows model using the SMC2 algorithm.
+BayesMallowsSMC2 provides functions for performing sequential inference in the Bayesian Mallows model using the SMC2 algorithm [@10.1214/25-BA1564].
 
 ## Installation
 
@@ -30,8 +31,43 @@ You can install the development version of BayesMallowsSMC2 from [GitHub](https:
 devtools::install_github("osorensen/BayesMallowsSMC2")
 ```
 
-## Usage
+## Example
 
-This package is under development, and is not yet well documented. For examples on how to use it, see the code in the OSF repository https://osf.io/pquk4/.
+Here is a basic example using the included `complete_rankings` dataset:
 
+```{r example}
+library(BayesMallowsSMC2)
+
+# Fit the model with complete rankings
+set.seed(123)
+mod <- compute_sequentially(
+  complete_rankings,
+  hyperparameters = set_hyperparameters(n_items = 5),
+  smc_options = set_smc_options(n_particles = 100, n_particle_filters = 1)
+)
+
+# Print model summary
+print(mod)
+```
+
+### Posterior Summaries
+
+We can visualize the posterior distributions of the parameters:
+
+```{r posterior-alpha}
+# Posterior distribution of alpha (dispersion parameter)
+plot(mod, parameter = "alpha")
+```
+
+```{r posterior-tau}
+# Posterior distribution of tau (precision parameter)
+plot(mod, parameter = "tau")
+```
+
+```{r posterior-rho}
+# Posterior distribution of rho (ranking positions)
+plot(mod, parameter = "rho", items = c(1, 2, 3))
+```
+
+## References
 

inst/REFERENCES.bib

@@ -0,0 +1,11 @@
+@article{10.1214/25-BA1564,
+author = {{\O}ystein S{\o}rensen and Anja Stein and Waldir Leoncio Netto and David S. Leslie},
+title = {{Sequential Rank and Preference Learning with the Bayesian Mallows Model}},
+journal = {Bayesian Analysis},
+publisher = {International Society for Bayesian Analysis},
+pages = {1 -- 26},
+keywords = {Mallows mixtures, partial rankings, particle filter, preference learning, SMC2},
+year = {2025},
+doi = {10.1214/25-BA1564},
+URL = {https://doi.org/10.1214/25-BA1564}
+}