Codeberg/Documentation
42
199
Fork
You've already forked Documentation
161

Tags need to be pushed to the remote target #228

Merged
Ghost merged 4 commits from mutluyuz/Documentation:push-tags into main 2022年05月10日 08:09:38 +02:00
Contributor
Copy link

Add a note that tags need to be pushed to the remote target.

Please let me know, if you have any suggestions to improve the wording and this paragraph.

Add a note that tags need to be pushed to the remote target. Please let me know, if you have any suggestions to improve the wording and this paragraph.
Add a note that tags need to be pushed to the remote target.
Signed-off-by: mutluyuz <mutluyuz@noreply.codeberg.org>
@ -28,1 +28,4 @@
Please note that tags are not automatically pushed using `git push` (comparable to branches). Thus, they have to be pushed to the remote target:
```bash
git push <remote target, probably "origin"> <version number here, e.g., "v1.2.3">
Owner
Copy link

Maybe we could offer the user to use the --tags argument? No need to specify the specific tag.

Maybe we could offer the user to use the `--tags` argument? No need to specify the specific tag.
Author
Contributor
Copy link

Thanks for the suggestions! I used the tag name because otherwise every tag is pushed what might be undesired. I added a note to the docs and mentioned both ways. What do you think about that?

Thanks for the suggestions! I used the tag name because otherwise every tag is pushed what might be undesired. I added a note to the docs and mentioned both ways. What do you think about that?
Owner
Copy link

lgtm.

lgtm.
Gusted marked this conversation as resolved
@ -26,6 +26,16 @@ To create a tag using git, use the following command in your repo folder.
git tag -a <version number here> -m "<my tag name>"
```
Tags are not automatically pushed using `git push` (comparable to branches). Thus, they have to be pushed manually to the reemote target:
Contributor
Copy link

There is a typo here:

reemote -> remote

There is a typo here: reemote -> remote
Author
Contributor
Copy link

Thanks!

Thanks!
mutluyuz marked this conversation as resolved
@ -29,0 +33,4 @@
The argument `--tags` pushes all local tags to the remote target. If you want to push only a specific tag, use:
```bash
git push <remote target, probably "origin"> <version number here, e.g., "v1.2.3">
Contributor
Copy link

Why do you name it "version number"? Wouldn't tag name be better suited here?

git push <remote target, probably "origin"> <specific tag name, e.g., "v1.2.3">

Why do you name it "version number"? Wouldn't tag name be better suited here? git push <remote target, probably "origin"> <specific tag name, e.g., "v1.2.3">
Author
Contributor
Copy link

I agree with you. I called it version number because of this line:

git tag -a <version number here> -m "<my tag name>"

According to here, a specifies the annotation and m the tag message. I will adapt this also to make things clearer.

I agree with you. I called it version number because of this line: > `git tag -a <version number here> -m "<my tag name>"` According to [here](https://git-scm.com/book/en/v2/Git-Basics-Tagging), `a` specifies the annotation and `m` the tag message. I will adapt this also to make things clearer.
Ghost approved these changes 2022年05月08日 20:00:07 +02:00

Do you think it's worth adding a hint to the --follow-tags option?

https://git-scm.com/docs/git-push#Documentation/git-push.txt---follow-tags

Do you think it's worth adding a hint to the `--follow-tags` option? https://git-scm.com/docs/git-push#Documentation/git-push.txt---follow-tags
Author
Contributor
Copy link

Mmh, I'm not sure whether the follow-tags option might complicate things a bit. As I understand it, the codeberg documentation is for a fast and simple introduction to the topic. Thus, I would leave follow-tags to the more interested reader of a deeper introduction to git. What do you think? What was your reason to propose the option?

Mmh, I'm not sure whether the `follow-tags` option might complicate things a bit. As I understand it, the codeberg documentation is for a fast and simple introduction to the topic. Thus, I would leave `follow-tags` to the more interested reader of a deeper introduction to git. What do you think? What was your reason to propose the option?

Nevermind, i was just referencing my use case, but others may have different use cases.

We go with the your proposal, everybody is free to propose additions afterwards.

Thank you very much for your efforts.

Nevermind, i was just referencing my use case, but others may have different use cases. We go with the your proposal, everybody is free to propose additions afterwards. Thank you very much for your efforts.
Sign in to join this conversation.
No reviewers
Labels
Clear labels
Codeberg Pages
Issues affecting Codeberg Pages
Documentation Usability
Issues related to using and reading docs.codeberg.org
Forgejo
Good First Issue! 👋
Kind: Bug
Kind: Documentation
Kind: Enhancement
Kind: Feature
Kind: Question
Kind: Security
Licensing
Part: Generator
This is related to the generation of the documentation, not to the content itself
Priority: High
The priority is high
Priority: Low
The priority is low
Priority: Medium
The priority is medium
Reviewed: Confirmed
Something has been confirmed
Reviewed: Duplicate
Something exists already
Reviewed: Invalid
Something was marked as invalid
Reviewed: Wontfix
Something won't be fixed
Status: Blocked
Status: Help wanted
Contributions are welcome!
Status: In progress
Work is in progress
Status: Needs feedback
Feedback is needed
Status: Ready for Review
Work is completed
Status: Review
Review is in progress / Reviewers wanted
Status: Stale
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
5 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Codeberg/Documentation!228
Reference in a new issue
Codeberg/Documentation
No description provided.
Delete branch "mutluyuz/Documentation:push-tags"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?