mirror of
https://github.com/goreleaser/goreleaser.git
synced 2025-03-25 21:29:14 +02:00
<!-- Hi, thanks for contributing! Please make sure you read our CONTRIBUTING guide. Also, add tests and the respective documentation changes as well. --> <!-- If applied, this commit will... --> This commit will fix bad version tag sort if there is a prerelease on the same commit as a release tag. Current output is shown below ``` ❯ git tag --points-at HEAD --sort=-version:refname --format='%(creatordate)%09%(refname)' Thu Mar 2 21:38:51 2023 +0300 refs/tags/v1.13.0-rc3 Thu Mar 2 21:38:51 2023 +0300 refs/tags/v1.13.0 ``` Test is changed to match current default value so it will fail without this fix. Default value `-` is set to the one that is described inside [docs](https://goreleaser.com/how-it-works/?h=prerelease#how-it-works), but people are still allowed to change it. Output with fix applied ``` ❯ git -c versionsort.suffix=- tag --points-at HEAD --sort -version:refname --format='%(creatordate)%09%(refname)' Thu Mar 2 21:38:51 2023 +0300 refs/tags/v1.13.0 Thu Mar 2 21:38:51 2023 +0300 refs/tags/v1.13.0-rc3 ``` <!-- # Provide links to any relevant tickets, URLs or other resources --> More info about `versionsort.suffix` can be found [here](https://github.com/git/git/blob/master/Documentation/config/versionsort.txt#L5) Docs as well both schemas are updated as well. I am not sure if users should be allowed to change this option at all.
Documentation
Documentation is written in mkdocs and there are a few extensions that allow richer authoring than markdown.
To iterate with documentation, therefore, it is recommended to run the mkdocs server and view your pages in a browser.
Prerequisites
NOTE to M1/M2 mac owners
If running on an arm64-based mac (M1 or M2, aka "Applie Silicon"), you may find this method quite slow. Until multiarch docker images can be built and made available, you may wish to build your own via:
git clone git@github.com:squidfunk/mkdocs-material.git
docker build -t docker.io/squidfunk/mkdocs-material .