fix(install): improve git_clean function

The commit refactors the git_clean function and adds a better documentation to explain its behavior. The fetch command is updated to pull tags with the remote branch. Also, the reset command is set to the latest tag fetched, ensuring that the function is always using the latest tag available. Finally, a command to remove all untracked files and directories was added to keep the repository clean.

.github/workflows/deploy-docs.yaml

@@ -10,8 +10,7 @@ on:
     paths:
       - "README.md"
       - "mkdocs.yaml"
-      - "docs/**.md"
-      - "docs/images/**"
+      - "docs/**/*"
       - ".github/workflows/deploy-docs.yaml"
 
 permissions:

docs/install

@@ -61,9 +61,14 @@ git_clean() {
   log_task "Cleaning '${path}' with '${remote}' at branch '${branch}'"
   git="git -C ${path}"
   ${git} checkout -B "${branch}"
-  ${git} fetch "${remote}" "${branch}"
-  latest_tag=$(${git} describe --tags "$(${git} rev-list --tags --max-count=1)") # get latest tag
-  ${git} reset --hard "${latest_tag}"                                            # use latest tag instead of FETCH_HEAD
+  ${git} fetch "${remote}" "${branch}" --tags
+  # get latest tag
+  latest_tag=$(${git} describe --tags "$(${git} rev-list --tags --max-count=1)")
+  # ensure to pull the latest tag
+  ${git} fetch "${remote}" "${latest_tag}"
+  # reset to latest tag
+  ${git} reset --hard "${latest_tag}"
+  # remove all untracked files and directories
   ${git} clean -fdx
   unset path remote branch git
 }