Skip to content

Make package description in metadata and README more generic - #140

Merged
matt-graham merged 2 commits into
mainfrom
mmg/update-description
Sep 7, 2026
Merged

Make package description in metadata and README more generic#140
matt-graham merged 2 commits into
mainfrom
mmg/update-description

Conversation

@matt-graham

Copy link
Copy Markdown
Collaborator

Resolves #131

Broadens scope of package description in DESCRIPTION file and also shortens this to cover only key high level details.
The more detailed package description in README is also broadened to concentrate less on Barker proposal specifically and highlight modular design of package.

@matt-graham
matt-graham requested a review from sam0287 July 23, 2026 13:47
@matt-graham matt-graham added the documentation Improvements or additions to documentation label Jul 23, 2026
@codecov

codecov Bot commented Jul 23, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (eb90251) to head (fc2ea78).

Additional details and impacted files
@@            Coverage Diff            @@
##              main      #140   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           11        11           
  Lines          762       762           
=========================================
  Hits           762       762           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Comment thread DESCRIPTION Outdated
available on GitHub <https://github.com/roualdes/bridgestan>, is installed,
then 'BridgeStan' can be used to specify the target distribution to sample
from.
Description: Functions for simulating Markov chains using random-walk, Langevin,

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggest not mentioning specific algorithms here, broaden instead to simulating and comparing Markov chain algorithms, mention that we have these ones pre-coded but users can add others bla bla bla

Comment thread README.md Outdated
proposal to compute *Markov chain Monte Carlo* (MCMC) estimates of
expectations with respect to a target distribution on a real-valued
vector space. The Barker proposal, described in [Livingstone and Zanella
`rmcmc` is an R package for simulating Markov chains using random-walk,

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Same comment here, better not to focus so much on any specific algorithm

Comment thread README.Rmd Outdated
`rmcmc` is an R package for simulating Markov chains using the Barker proposal
to compute _Markov chain Monte Carlo_ (MCMC) estimates of expectations with
respect to a target distribution on a real-valued vector space.
`rmcmc` is an R package for simulating Markov chains using random-walk, Langevin,

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Same comment as above

@matt-graham
matt-graham requested a review from sam0287 September 7, 2026 09:58
@matt-graham

Copy link
Copy Markdown
Collaborator Author

@sam0287 I've updated the descriptions in README and metadata to avoid focussing on specific algorithms as per your review comments and emphasise the ability for users to add their own algorithms. If you're happy with these changes either comment here or you can use the 'Approve' button from review interface (go to files tab).

@sam0287 sam0287 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Yes looks good now

@matt-graham
matt-graham merged commit e89f298 into main Sep 7, 2026
10 checks passed
@matt-graham
matt-graham deleted the mmg/update-description branch September 7, 2026 13:33
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update README to reflect broader scope of package

2 participants