- introduce new step, showcasing generation of changelog for an external configuration

.github/workflows/ci.yml

@@ -10,10 +10,13 @@ jobs:
     if: github.event_name  == 'pull_request'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - name: Checkout
-      - run: |
+        uses: actions/checkout@v2
+      - name: Install NPM
+        run: |
           npm install
-      - run: |
+      - name: Run NPM
+        run: |
           npm run all
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -22,10 +25,12 @@ jobs:
     if: github.event_name  == 'pull_request'
     runs-on: ubuntu-latest
     steps:
+      # the below actions use the local state of the action. please replace `./` with `mikepenz/release-changelog-builder-action@{latest-release}`
+      # Showcases how to use the action without a prior checkout
       # Won't support providing a configuration file, as no checkout was done
       - name: "Configuration without Checkout"
         id: without_checkout
-        uses: mikepenz/release-changelog-builder-action@develop
+        uses: ./
         with:
           toTag: "v0.0.3"
         env:
@@ -36,9 +41,8 @@ jobs:
 
       - name: Checkout
         uses: actions/checkout@v2
-        with:
-          fetch-depth: 0 # Checkout full depth so tags can be discovered automatically if not specified
 
+        # Showcase the most minimal configuration possible
       - name: "Minimal Configuration"
         id: minimal_release
         uses: ./
@@ -48,6 +52,7 @@ jobs:
       - name: Echo Minimal Configuration Changelog
         run: echo "${{steps.minimal_release.outputs.changelog}}"
 
+        # Showcases a more complex configuration, providing a configuration, and specifically referencing owner, repo, from and to tag
       - name: "Complex Configuration"
         id: complex_release
         uses: ./
@@ -62,6 +67,21 @@ jobs:
       - name: Echo Complex Configuration Changelog
         run: echo "${{steps.complex_release.outputs.changelog}}"
 
+        # Showcases the capability to generate the changelog for an external repository provided
+      - name: "External Repo Configuration"
+        id: external_changelog
+        uses: ./
+        with:
+          configuration: "configs/configuration_complex.json"
+          owner: "mikepenz"
+          repo: "MaterialDrawer"
+          fromTag: "v8.1.0"
+          toTag: "v8.1.6"
+          token: ${{ secrets.PERSONAL_TOKEN }}
+
+      - name: Echo External Repo Configuration Changelog
+        run: echo "${{steps.external_changelog.outputs.changelog}}"
+
   release:
     if: startsWith(github.ref, 'refs/tags/')
     runs-on: ubuntu-latest