feat(git-lfs): use Git LFS for /cache and /generated folders

.gitattributes

@@ -0,0 +1,2 @@
+generated/*.json filter=lfs diff=lfs merge=lfs -text
+cache/*.json filter=lfs diff=lfs merge=lfs -text

.github/workflows/codeql-analysis.yml

@@ -39,6 +39,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3 # tag=v3
+        with:
+          lfs: true
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL

.github/workflows/release.yml

@@ -12,6 +12,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+        with:
+          lfs: true
       - uses: actions/setup-node@v3
         with:
           node-version: lts/*

.github/workflows/test.yml

@@ -12,6 +12,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+        with:
+          lfs: true
       - uses: actions/setup-node@v3
         with:
           node-version: lts/*

.github/workflows/update-prettier.yml

@@ -9,6 +9,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+        with:
+          lfs: true
       - uses: actions/setup-node@v3
         with:
           node-version: lts/*

.github/workflows/update.yml

@@ -8,6 +8,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+        with:
+          lfs: true
       - uses: actions/setup-node@v3
         with:
           cache: npm

.github/workflows/update_dry_run.yml

@@ -18,6 +18,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+        with:
+          lfs: true
       - uses: actions/setup-node@v3
         with:
           cache: npm

CONTRIBUTING.md

@@ -79,3 +79,13 @@ Besides publishing a new version to npm, semantic-release also creates a git tag
 on GitHub, generates changelogs from the commit messages and puts them into the release notes.
 
 If the pull request looks good but does not follow the commit conventions, use the <kbd>Squash & merge</kbd> button.
+
+## Troubleshooting
+
+### When I clone the repository, files in `cached/` and `generated/` are empty
+
+These folders are versioned using [Git Large File Storage](https://git-lfs.com/). Not having `git lfs` installed on your local machine could be the reason of this issue.
+You can download `Git LFS` and find the install steps here: [https://git-lfs.com/](https://git-lfs.com/)
+
+If you would like to configure your local machine to show diffs for the files under LFS there's [this hack](https://github.com/git-lfs/git-lfs/issues/440#issuecomment-500871343):
+`git config diff.lfs.textconv cat`