Skip to content

Commit 9bb4d53

Browse files
chore: add example to readme
1 parent 4b2d137 commit 9bb4d53

File tree

1 file changed

+24
-3
lines changed

1 file changed

+24
-3
lines changed

README.md

Lines changed: 24 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,14 @@
11
# Documentation Github Pages Action
22

3-
A composite Github Action to generate code, OpenAPI and AsyncAPI documentation and to deploy it on Github Pages.
3+
4+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=plastic)](https://opensource.org/licenses/MIT)
5+
![Version](https://img.shields.io/github/v/release/smartoperatingblock/documentation-ghp-action?style=plastic)
6+
7+
A composite **Github Action** to generate *code*, *OpenAPI* and *AsyncAPI* documentation and to deploy it on Github Pages.
48

59
## Setup
610
Choose the types of documentation you want to generate by putting true on this input parameters:
7-
- `should-generate-code-documentaion`
11+
- `should-generate-code-documentation`
812
- `should-generate-openapi-documentaion`
913
- `should-generate-asyncapi-documentaion`
1014

@@ -18,6 +22,23 @@ For every selected type specify the command, input file and destination folder o
1822

1923
## Example
2024

21-
An example of action usage with all types of documentations
25+
An example of how to use the action with all types of documentations and inputs:
2226
```yaml
27+
jobs:
28+
documentation:
29+
runs-on: ubuntu-latest
30+
steps:
31+
- name: Checkout
32+
uses: actions/checkout@v3
33+
- uses: SmartOperatingBlock/documentation-ghp-action@1.0.0
34+
with:
35+
should-generate-code-documentation: true
36+
code-documentation-generation-command: ./gradlew dokkaHtml
37+
code-documentation-dst-folder: 'build/code-doc/'
38+
should-generate-openapi-documentation: true
39+
openapi-documentation-input-file: 'docs/openapi/openapi.yml'
40+
openapi-documentation-dst-folder: 'build/openapi-doc/'
41+
should-generate-asyncapi-documentation: true
42+
asyncapi-documentation-input-file: 'docs/asyncapi/asyncapi.yml'
43+
asyncapi-documentation-dst-folder: 'build/asyncapi-doc/'
2344
```

0 commit comments

Comments
 (0)