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  
610Choose 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