Skip to content

Commit 1036982

Browse files
committed
add contrib
1 parent 1bc62ff commit 1036982

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

CONTRIBUTING.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Contributions
2+
3+
Desirable contributions for this repository are primarily short notebooks that demonstrate the use of the nested sampling algorithm on physics problems. Typically this will involve some modelling code / likelihood code that is written in jax, and would like to capitalise on the hardware acceleration possible whilst still computing partition functions/model evidences.
4+
5+
## Contributing guide
6+
7+
- Raise an issue or submit a PR to discuss the example you would like to add.
8+
- Clone the repo and switch to a new branch to contribute your example via a PR.
9+
- Make an example notebook and run it locally. The visual state of the notebook is copied to the book page.
10+
- Include references to codes / non-standard dependencies as links (see the quickstart example)
11+
- Include bibtex references in the references.bib file and call them in markdown by adding `{cite}`name of ref``
12+
- Add the notebook to the appropriate part of the file tree and track it in git
13+
- Edit the `_toc.yml` file to include the notebook in the table of contents (and hence have it picked up by jupyter book)
14+
- Add yourself to the contributors.md file
15+
- `pip install jupyter-book` to install locally then, run the following to test the page builds
16+
```bash
17+
jb build .
18+
```

0 commit comments

Comments
 (0)