h759bkyo4/Documentation
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

Added screenshot and rewrote part of tags article

Browse source
This commit is contained in:
n 2020-12-06 21:30:22 +09:00 committed by Gitea
parent 506c6a4c90
commit f4feca6984
4 changed files with 10 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

BIN
assets/images/git/using-tags/tags.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 79 KiB

BIN
assets/images/git/using-tags/tags.webp Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 38 KiB

23
content/git/using-tags.md
View file

@ -6,10 +6,10 @@ eleventyNavigation:
order: 60
---
# What are tags and releases?
## What are tags and releases?
Tags are a git function used to show where a repository was during a certain release (e.g. v1.2.4), sort of like a shortcut to what it looked like at the time. Tags always include a source code download for that time, and are usually paired with a release (e.g. an EXE or DMG file) when applicable.
## Wait, what is the difference between tags and releases?
### Wait, what is the difference between tags and releases?
They are very similar, the difference being that tags are just the repository frozen in time and are part of git (You can make one using git), releases are tags accompanied with a binary file and are not part of git (You need to go to your Codeberg repository page to add the binary).
## Making new tags
@ -24,16 +24,11 @@ git tag -a <version number here> -m "<my tag name>"
```
It is good practice to prefix the version number with a `v` (e.g. `v1.2.3`) and to use [semantic versioning](https://semver.org/). It should also be noted that this method will not allow you to add a binary file, you will need to go to your repo page for that.
## Finding and viewing tags in a repository
### Step 1: Go to the releases tab in the repository
TODO SCREENSHOT [of the release tab]
### Step 2: Find the tag that you want to view
In this example, we will be viewing v1.1.2
TODO SCREENSHOT [of scrolling down tag list with some releases]
### Step 3: Viewing the tag
If you just want the release, select it to download, if you want to see the code at the time the tag was released, select a source code download, or click the version number.
TODO SCREENSHOT [of clicking tag]
## Finding and viewing releases in a repository
<picture>
<source srcset="/assets/images/git/using-tags/tags.webp" type="image/webp">
<img src="/assets/images/git/using-tags/tags.png" alt="tags">
</picture>
To view the release, go to the releases tab (1) in the repository. Then locate the release you want to view. For example, we will be looking at the `Added Knut!` release (2). If you just want to access the files attached to the release, you can download it from the `Downloads` dropdown (3).
If you want to see a snapshot of the source code at the time of the release, select a source code archive download (5) from the `Downloads` dropdown or click on the tag on the left side (5).

2
package-lock.json generated
View file

@ -3521,4 +3521,4 @@
"dev": true
}
}
}
}