diff --git a/.github/workflows/CreateDocs.yml b/.github/workflows/CreateDocs.yml index 1882500b24..0417849adf 100644 --- a/.github/workflows/CreateDocs.yml +++ b/.github/workflows/CreateDocs.yml @@ -4,7 +4,7 @@ on: inputs: branches: description: "JSON array of branches: ['18','20'] (no spaces)" - required: true + required: false type: string schedule: # Times are UTC @@ -14,15 +14,29 @@ env: ASTERISK_REPO: ${{ github.repository }} GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + DEFAULT_BRANCHES: ${{ vars.WIKIDOC_BRANCHES }} + INPUT_BRANCHES: ${{ inputs.branches }} jobs: + CreateDocsDebug: runs-on: ubuntu-latest + outputs: + manual_branches: ${{ steps.setup.outputs.manual_branches }} steps: + - name: setup + run: | + MANUAL_BRANCHES="$INPUT_BRANCHES" + [ -z "$MANUAL_BRANCHES" ] && MANUAL_BRANCHES="$DEFAULT_BRANCHES" || : + echo "manual_branches=${MANUAL_BRANCHES}" + echo "manual_branches=${MANUAL_BRANCHES}" >>${GITHUB_OUTPUT} + exit 0 + - name: DumpEnvironment uses: asterisk/asterisk-ci-actions/DumpEnvironmentAction@main with: - action-vars: ${{toJSON(inputs)}} + action-inputs: ${{toJSON(inputs)}} + action-vars: ${{ toJSON(steps.setup.outputs) }} CreateDocsScheduledMatrix: needs: [ CreateDocsDebug ] @@ -73,7 +87,7 @@ jobs: strategy: fail-fast: false matrix: - branch: ${{ fromJSON(inputs.branches) }} + branch: ${{ fromJSON(vars.WIKIDOC_MANUAL_BRANCHES) }} runs-on: ubuntu-latest steps: - name: CreateDocs for ${{matrix.branch}} diff --git a/rest-api-templates/api.wiki.mustache b/rest-api-templates/api.wiki.mustache index ba96d99ad2..c40ca803d5 100644 --- a/rest-api-templates/api.wiki.mustache +++ b/rest-api-templates/api.wiki.mustache @@ -5,14 +5,14 @@ |:------ |:------------------------------------ |:------------ |:------- | {{#apis}} {{#operations}} -| {{http_method}} | [{{wiki_path}}](#{{nickname}}) | {{#response_class}}{{#is_primitive}}{{name}}{{/is_primitive}}{{^is_primitive}}[{{wiki_name}}]({{wiki_prefix}}Asterisk_REST_Data_Models#{{lc_singular_name}}){{/is_primitive}}{{/response_class}} | {{{summary}}} | +| {{http_method}} | [{{wiki_path}}](#{{nickname_lc}}) | {{#response_class}}{{#is_primitive}}{{name}}{{/is_primitive}}{{^is_primitive}}[{{wiki_name}}]({{wiki_prefix}}Asterisk_REST_Data_Models#{{lc_singular_name}}){{/is_primitive}}{{/response_class}} | {{{summary}}} | {{/operations}} {{/apis}} {{#apis}} {{#operations}} --- -[//]: # (anchor:{{nickname}}) +[//]: # (anchor:{{nickname_lc}}) ## {{nickname}} ### {{http_method}} {{wiki_path}} {{{wiki_summary}}}{{#wiki_notes}} {{{wiki_notes}}}{{/wiki_notes}} diff --git a/rest-api-templates/swagger_model.py b/rest-api-templates/swagger_model.py index 680be7fe30..23dcb8cbf1 100644 --- a/rest-api-templates/swagger_model.py +++ b/rest-api-templates/swagger_model.py @@ -367,6 +367,7 @@ class Operation(Stringify): def __init__(self): self.http_method = None self.nickname = None + self.nickname_lc = None self.response_class = None self.parameters = [] self.summary = None @@ -378,6 +379,7 @@ class Operation(Stringify): validate_required_fields(op_json, self.required_fields, context) self.http_method = op_json.get('httpMethod') self.nickname = op_json.get('nickname') + self.nickname_lc = self.nickname.lower() response_class = op_json.get('responseClass') self.response_class = response_class and SwaggerType().load( response_class, processor, context)