Skip to content

eclipse-velocitas/release-documentation-action

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Release Documentation Render Action

The action documentation/render reads all input packages from the inboxPath and renders it as markdown to outboxPath. Available templates are stored in templatePath.

Use the actions/checkout@v4 action to clone the release-documentation-action to a dedicated path, Then appropriate action can be used as shown in below example

- name: Clone actions repository
  uses: actions/checkout@v4
  with:
    repository: eclipse-velocitas/release-documentation-action
    path: "./.github/actions"

Usage

- name: Render documentation (test-results)
  uses: ./.github/actions/render
  with:
    inboxPath: .vehicleApp/Documentation/Inbox/test-results
    outboxPath: .vehicleApp/Documentation/Outbox
    templatePath: ./.github/actions/templates

Location documentation/render

Inputs

Name Required Description Example values
inboxPath false path containing the packaged input files for the release documentation
outboxPath false output path for the rendered release documentation
templatePath false path to the templates used for release documentation generation ./.github/actions/templates

Release Documentation Package Action

The action documentation/package copies all files from sourcePath to the packagePath under a subfolder name. It also adds a metadata file to the folder containing name, type and format of the artifacts.

Location documentation/package

Use the actions/checkout@v4 action to clone the release-documentation-action to a dedicated path, Then appropriate action can be used as shown in below example

- name: Package integration test result files
  uses: ./.github/actions/package
  with:
    name: "IntegrationTest"
    type: "IntegrationTest"
    schema: "JUnit"
    sourcePath: .sdv/tmp/IntegrationTest
    packagePath: .sdv/tmp/Documentation/renderer

Inputs

Name Required Description Example values
name true arbitrary name for the artifact Unit Test Results Talent X
type true type of the artifact UnitTest, IntegrationTest, ContainerScan, ...
schema true format of the files junit, ...
sourcePath true folder where the action retrieves the raw result files
packagePath true target path where the results are copied to

Contributing

For guidance on setting up a development environment and how to make a contribution to the Velocitas Release Documentation Action, see the contributing guidelines.