Branch description

[Utopiah]

Feature Description

Branches have name and content but no description that would describe what they are or should be. Being able to use git branch --edit-description on remote and display back on Gitea on e.g /user_name/repository_name/src/branch/branch_name or /user_name/repository_name/branches would be quite useful for people browsing a repository.

Screenshots

No response

[lafriks]

Branch descriptions are stored locally in git config and can not be pushed to remote thus unless git client implements this feature there is not much we can do

[Utopiah]

Thanks, asked on git-devel IRC and will report back.

[eeyrjmr]

could the README.md be used for this since it is rendered in the view and thus can be unique per branch

[delvh]

I don't think that's a good idea.
How many READMEs do you know that are changed on branches except main?
I don't know of any.
And showing the whole README is not the point of showing a small branch description.

[lunny]

If #22743 merged, we can add a column in database to store the description.

[zeners]

@lunny branch-table exists in database, how about adding the description column?

Is markdown-support possible to leave links?
Who will be allowed to edit this description and how?

[lunny]

The permission of edit description should be the same as renaming branch.

[lunny]

This feature could be implementation on Gitea web UI or Tea CLI but I don't think it's easy to be implemented as git branch --edit-description