fix(release): lightweight tags in the snap build, version fallback, man pages for help topics, draft the 1.0.0 changelog

Signed-off-by: bircni <bircni@icloud.com>

snap/snapcraft.yaml

@@ -30,7 +30,7 @@ parts:
       craftctl default
 
       git config --global --add safe.directory /root/parts/tea/src
-      last_committed_tag="$(git for-each-ref --sort=taggerdate --format '%(tag)' refs/tags | tail -n 1)"
+      last_committed_tag="$(git for-each-ref --sort=creatordate --format '%(refname:short)' refs/tags | tail -n 1)"
       last_released_tag="$(snap info gitea-tea | awk '$1 == "latest/candidate:" { print $2 }')"
       # If the latest tag from the upstream project has not been released to
       # stable, build that tag instead of main.
@@ -39,7 +39,7 @@ parts:
         git checkout "${last_committed_tag}"
       fi
 
-      version="$(git describe --always | sed -e 's/-/+git/;y/-/./')"
+      version="$(git describe --tags --always | sed -e 's/-/+git/;y/-/./')"
       [ -n "$(echo $version | grep "+git")" ] && grade=devel || grade=stable
       craftctl set version="$version"
       craftctl set grade="$grade"