Skip to content

Commit e3208da

Browse files
committed
docs: add badges
1 parent 49036b8 commit e3208da

1 file changed

Lines changed: 18 additions & 17 deletions

File tree

README.md

Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,49 +2,50 @@
22

33
The user manual / documentation of OpenQDA
44

5-
[![Deploy to GitHub Pages](https://github.com/openqda/user-docs/actions/workflows/deploy.yml/badge.svg)](https://github.com/openqda/user-docs/actions/workflows/deploy.yml)
5+
[![Deploy VitePress site to Pages](https://github.com/openqda/user-docs/actions/workflows/deploy.yml/badge.svg)](https://github.com/openqda/user-docs/actions/workflows/deploy.yml)
66
![GitHub License](https://img.shields.io/github/license/openqda/user-docs)
7+
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
8+
![This is a research software documentation](https://img.shields.io/badge/software-documentation-blue?style=plastic)
9+
[![DOI](https://zenodo.org/badge/768506301.svg)](https://doi.org/10.5281/zenodo.11518216)
10+
711

812
## Website
913

1014
The documentation is available under https://openqda.github.io/user-docs/
1115

12-
It's built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
16+
It's built using [vitepress](https://vitepress.dev), a modern static website generator for documentations.
1317

1418
### Installation
1519

1620
```
17-
$ yarn
21+
$ npm install
1822
```
1923

2024
### Local Development
2125

2226
```
23-
$ yarn start
27+
$ npm run docs:dev
2428
```
2529

2630
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
2731

2832
### Build
2933

3034
```
31-
$ yarn build
35+
$ npm run docs:build
36+
$ npm run docs:preview # optional to locally peview your build output
3237
```
3338

34-
This command generates static content into the `build` directory and can be served using any static contents hosting service.
3539

3640
### Deployment
41+
We use GitHub actions to automatically deploy updates to GitHub pages.
42+
Any merges to `main` will trigger a new build to be deployed.
43+
Pull requests, however will not trigger builds.
3744

38-
Using SSH:
39-
40-
```
41-
$ USE_SSH=true yarn deploy
42-
```
45+
### Contributing
46+
We welcome your contribution and appreciate your support!
47+
Please read our contribution guidelines in order to make your contribution a success.
4348

44-
Not using SSH:
45-
46-
```
47-
$ GIT_USER=<Your GitHub username> yarn deploy
48-
```
49+
## License
4950

50-
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
51+
See [license file](./LICENSE)

0 commit comments

Comments
 (0)