You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gitea/docs/content/doc/administration
JakobDev aaa1094663
Add the ability to pin Issues (#24406)
This adds the ability to pin important Issues and Pull Requests. You can
also move pinned Issues around to change their Position. Resolves #2175.

## Screenshots

![grafik](https://user-images.githubusercontent.com/15185051/235123207-0aa39869-bb48-45c3-abe2-ba1e836046ec.png)

![grafik](https://user-images.githubusercontent.com/15185051/235123297-152a16ea-a857-451d-9a42-61f2cd54dd75.png)

![grafik](https://user-images.githubusercontent.com/15185051/235640782-cbfe25ec-6254-479a-a3de-133e585d7a2d.png)

The Design was mostly copied from the Projects Board.

## Implementation
This uses a new `pin_order` Column in the `issue` table. If the value is
set to 0, the Issue is not pinned. If it's set to a bigger value, the
value is the Position. 1 means it's the first pinned Issue, 2 means it's
the second one etc. This is dived into Issues and Pull requests for each
Repo.

## TODO
- [x] You can currently pin as many Issues as you want. Maybe we should
add a Limit, which is configurable. GitHub uses 3, but I prefer 6, as
this is better for bigger Projects, but I'm open for suggestions.
- [x] Pin and Unpin events need to be added to the Issue history.
- [x] Tests
- [x] Migration

**The feature itself is currently fully working, so tester who may find
weird edge cases are very welcome!**

---------

Co-authored-by: silverwind <me@silverwind.io>
Co-authored-by: Giteabot <teabot@gitea.io>
2 years ago
..
_index.en-us.md Refactor docs (#23752) 2 years ago
_index.zh-cn.md Refactor docs (#23752) 2 years ago
_index.zh-tw.md Refactor docs (#23752) 2 years ago
adding-legal-pages.en-us.md Refactor docs (#23752) 2 years ago
adding-legal-pages.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
backup-and-restore.en-us.md Refactor docs (#23752) 2 years ago
backup-and-restore.zh-cn.md Remove unnecessary usage prefix from doc titles (#24869) 2 years ago
backup-and-restore.zh-tw.md Refactor docs (#23752) 2 years ago
cmd-embedded.en-us.md Remove `font-awesome` and fomantic `icon` module (#24471) 2 years ago
cmd-embedded.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
command-line.en-us.md Update LDAP filters to include both username and email address (#24547) 2 years ago
command-line.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
config-cheat-sheet.en-us.md Add the ability to pin Issues (#24406) 2 years ago
config-cheat-sheet.zh-cn.md Update Asciidoc markup example with safe defaults (#24920) 2 years ago
customizing-gitea.en-us.md Support changing git config through `app.ini`, use `diff.algorithm=histogram` by default (#24860) 2 years ago
customizing-gitea.zh-cn.md Refactor docs (#23752) 2 years ago
email-setup.en-us.md Refactor docs (#23752) 2 years ago
email-setup.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
environment-variables.en-us.md Refactor docs (#23752) 2 years ago
environment-variables.zh-cn.md Refactor docs (#23752) 2 years ago
external-renderers.en-us.md Refactor docs (#23752) 2 years ago
external-renderers.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
fail2ban-setup.en-us.md Refactor docs (#23752) 2 years ago
fail2ban-setup.zh-cn.md Refactor docs (#23752) 2 years ago
git-lfs-support.en-us.md Refactor docs (#23752) 2 years ago
git-lfs-support.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
https-support.en-us.md Refactor docs (#23752) 2 years ago
https-support.zh-cn.md Remove unnecessary usage prefix from doc titles (#24869) 2 years ago
logging-config.en-us.md Rewrite logger system (#24726) 2 years ago
logging-config.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
mail-templates.en-us.md Refactor docs (#23752) 2 years ago
mail-templates.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
repo-indexer.en-us.md Rewrite queue (#24505) 2 years ago
repo-indexer.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
reverse-proxies.en-us.md Improve reverse-proxy document and fix nginx config bug (#24616) 2 years ago
reverse-proxies.zh-cn.md Remove unnecessary usage prefix from doc titles (#24869) 2 years ago
search-engines-indexation.en-us.md Refactor docs (#23752) 2 years ago
search-engines-indexation.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
signing.en-us.md Refactor docs (#23752) 2 years ago
signing.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago