Skip to content

Commit 8a333d8

Browse files
author
Lisa Julia Nebel
committed
Add README.md
0 parents  commit 8a333d8

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

README.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Repository to host the Python documentation for OPM Flow
2+
3+
## Building the documentation locally
4+
- Copy [docstrings_simulators.json](https://raw.githubusercontent.com/OPM/opm-simulators/master/python/docstrings_simulators.json) to the python folder
5+
- Copy [docstrings_common.json](https://raw.githubusercontent.com/OPM/opm-common/master/python/docstrings_common.json) to the python folder
6+
- Copy [dune.module](https://raw.githubusercontent.com/OPM/opm-simulators/master/dune.module) to the root folder (opm-python-documentation)
7+
8+
## Building the documentation online on your fork
9+
- Turn on github actions at `https://github.com/<your-github-username>/opm-python-documentation/actions`
10+
- Push any changes to a branch of your fork, this should trigger a build of the documentation, where the built documentation is pushed to the branch `gh-pages-<name-of-your-branch>`
11+
- Then you can turn on github pages for your fork at `https://github.com/<your-github-username>/opm-python-documentation/settings/pages`
12+
- Select the branch `gh-pages-<name-of-your-branch>` as the source for your github page
13+
- Then you can have a look at the documentation with your changes at `https://<your-github-username>.github.io/opm-python-documentation/<name-of-your-branch>/index.html`
14+
- If everything looks fine, create a pull request for the master branch of this repository :)

0 commit comments

Comments
 (0)