forgejo/docs/content/usage
6543 ff8f7a7a0d
Extend issue template yaml engine (#29274)
Add new option:

`visible`: witch can hide a specific field of the form or the created
content afterwards

It is a string array witch can contain `form` and `content`. If only
`form` is present, it wont show up in the created issue afterwards and
the other way around. By default it sets both except for markdown

As they are optional and github don't have any similar thing, it is non
breaking and also do not conflict with it.

With this you can:
- define "post issue creation" elements like a TODO list to track an
issue state
- make sure to have a checkbox that reminds the user to check for a
thing but dont have it in the created issue afterwards
- define markdown for the created issue (was the downside of using yaml
instead of md in the past)
 - ...

## Demo

```yaml
name: New Contribution
description: External Contributor creating a pull

body:
- type: checkboxes
  id: extern-todo
  visible: [form]
  attributes:
    label: Contribution Guidelines
    options:
      - label: I checked there exist no similar feature to be extended
        required: true
      - label: I did read the CONTRIBUTION.MD
        required: true
- type: checkboxes
  id: intern-todo
  visible: [content]
  attributes:
    label: Maintainer Check-List
    options:
      - label: Does this pull follow the KISS principe
      - label: Checked if internal bord was notifyed
# ....
```
[Demo
Video](https://cloud.obermui.de/s/tm34fSAbJp9qw9z/download/vid-20240220-152751.mkv)

---
*Sponsored by Kithara Software GmbH*

---------

Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Co-authored-by: delvh <dev.lh@web.de>
(cherry picked from commit 77e29e0c39392f142627303bd798fb55258072b2)
2024-03-06 12:10:47 +08:00
..
actions Fix typos in the documentation (#29048) 2024-02-05 16:19:05 +08:00
packages [gitea] Fix incorrect link to swift doc and swift package-registry login command (#29096) 2024-02-10 10:53:43 +01:00
_index.en-us.md
_index.zh-cn.md
agit-support.en-us.md Update agit-support.en-us.md (#27652) 2023-10-17 17:53:36 +08:00
agit-support.zh-cn.md Change the default branch in the agit docs (#27621) 2023-10-14 09:50:23 -04:00
authentication.en-us.md docs: Update group membership fields to match application. (#28175) 2023-12-13 07:14:37 +00:00
authentication.zh-cn.md Fix some incorrect links in docs (#28191) 2023-11-24 13:57:09 +00:00
blame.en-us.md Support .git-blame-ignore-revs file (#26395) 2023-09-16 17:42:34 +00:00
clone-filter.en-us.md
clone-filter.zh-cn.md
code-owners.en-us.md
incoming-email.en-us.md
incoming-email.zh-cn.md
issue-pull-request-templates.en-us.md Extend issue template yaml engine (#29274) 2024-03-06 12:10:47 +08:00
issue-pull-request-templates.zh-cn.md
labels.en-us.md
labels.zh-cn.md Update documents to fix some links (#26885) 2023-09-03 18:45:20 +00:00
linked-references.en-us.md Update documents to fix some links (#26885) 2023-09-03 18:45:20 +00:00
linked-references.zh-cn.md Fix incorrect Chinese translation of linked-references.zh-cn.md (#27382) 2023-10-02 06:13:08 +00:00
merge-message-templates.en-us.md
merge-message-templates.zh-cn.md
multi-factor-authentication.en-us.md Update documents to fix some links (#26885) 2023-09-03 18:45:20 +00:00
permissions.en-us.md
permissions.zh-cn.md Update zh-cn documentation (#26406) 2023-08-14 01:35:49 -04:00
profile-readme.en-us.md Fix doc img path in profile readme (#28994) 2024-01-31 21:32:17 +08:00
profile-readme.zh-cn.md
protected-tags.en-us.md
protected-tags.zh-cn.md
pull-request.en-us.md Update documents to fix some links (#26885) 2023-09-03 18:45:20 +00:00
pull-request.zh-cn.md Update documents to fix some links (#26885) 2023-09-03 18:45:20 +00:00
push.en-us.md
push.zh-cn.md
repo-mirror.en-us.md Update repo-mirror.en-us.md (#28612) 2023-12-27 00:36:11 +08:00
repo-mirror.zh-cn.md Update zh-cn documentation (#26406) 2023-08-14 01:35:49 -04:00
secrets.en-us.md
secrets.zh-cn.md
template-repositories.en-us.md Rephrase template documentation to be more clear about .gitea/template (#27450) 2023-10-06 14:51:33 +08:00
template-repositories.zh-cn.md Update zh-cn documentation (#26406) 2023-08-14 01:35:49 -04:00
webhooks.en-us.md
webhooks.zh-cn.md