docs: document NOTICE_ON_SUCCESS for every cron task (#552)

Several cron tasks in the cheat sheet listed `ENABLE_SUCCESS_NOTICE` or `NO_SUCCESS_NOTICE`. Gitea reads neither, only `NOTICE_ON_SUCCESS`. `NO_SUCCESS_NOTICE` was removed in https://github.com/go-gitea/gitea/pull/19221.

1. Replace both dead keys with `NOTICE_ON_SUCCESS` (default `false`).
2. Fix "Notice if not success" descriptions, which inverted the key's meaning.
3. List the key for `cleanup_hook_task_table`, `cleanup_actions`, `cleanup_action_runs` and `gc_lfs`, which honor it but omitted it.

Matches https://github.com/go-gitea/gitea/pull/39352.

Written by Claude.

Reviewed-on: https://gitea.com/gitea/docs/pulls/552
Reviewed-by: Lunny Xiao <[email protected]>
Co-authored-by: silverwind <[email protected]>
This commit is contained in:
silverwind
2026-09-18 23:53:53 +00:00
committed by silverwind
parent 5db4089ae6
commit 779acd1cb9
20 changed files with 134 additions and 113 deletions
@@ -1079,7 +1079,7 @@ In-Reply-To =
- `ENABLED`: **true**: 啟用服務。
- `RUN_AT_START`: **false**: 在啟動時運行任務(如果啟用)。
- `ENABLE_SUCCESS_NOTICE`: **true**: 設定為 false 以關閉成功通知。
- `NOTICE_ON_SUCCESS`: **false**: 設定為 true 以打開成功通知。
- `SCHEDULE`: **@every 168h**: Cron 語法,用於安排任務,例如 `@every 168h`
- `HTTP_ENDPOINT`: **https://dl.gitea.com/gitea/version.json**: Gitea 用於檢查新版本的端點。
@@ -1087,7 +1087,7 @@ In-Reply-To =
- `ENABLED`: **false**: 啟用服務。
- `RUN_AT_START`: **false**: 在啟動時運行任務(如果啟用)。
- `NO_SUCCESS_NOTICE`: **false**: 設定為 true 以關閉成功通知。
- `NOTICE_ON_SUCCESS`: **false**: 設定為 true 以打開成功通知。
- `SCHEDULE`: **@every 168h**: Cron 語法,用於設定多長時間進行檢查。
- `OLDER_THAN`: **8760h**: 早於此表達式的任何系統通知都將從資料庫中刪除。
@@ -1108,35 +1108,35 @@ In-Reply-To =
- `ENABLED`: **true**: 啟用服務。
- `RUN_AT_START`: **true**: 在啟動時運行任務(如果啟用)。
- `NO_SUCCESS_NOTICE`: **false**: 設定為 true 以關閉成功通知。
- `NOTICE_ON_SUCCESS`: **false**: 設定為 true 以打開成功通知。
- `SCHEDULE`: **@annually**: Cron 語法,用於設定重建索引的頻率。
#### Cron - 停止長時間未更新的運行中任務 (`cron.stop_zombie_tasks`)
- `ENABLED`: **true**: 啟用服務。
- `RUN_AT_START`: **true**: 在啟動時運行任務(如果啟用)。
- `NO_SUCCESS_NOTICE`: **false**: 設定為 true 以關閉成功通知。
- `NOTICE_ON_SUCCESS`: **false**: 設定為 true 以打開成功通知。
- `SCHEDULE`: **@every 5m**: Cron 語法,用於設定檢查的頻率。
#### Cron - 停止持續更新但長時間未結束的運行中任務 (`cron.stop_endless_tasks`)
- `ENABLED`: **true**: 啟用服務。
- `RUN_AT_START`: **true**: 在啟動時運行任務(如果啟用)。
- `NO_SUCCESS_NOTICE`: **false**: 設定為 true 以關閉成功通知。
- `NOTICE_ON_SUCCESS`: **false**: 設定為 true 以打開成功通知。
- `SCHEDULE`: **@every 30m**: Cron 語法,用於設定檢查的頻率。
#### Cron - 取消長時間未被領取的任務 (`cron.cancel_abandoned_jobs`)
- `ENABLED`: **true**: 啟用服務。
- `RUN_AT_START`: **false**: 在啟動時運行任務(如果啟用)。
- `NO_SUCCESS_NOTICE`: **false**: 設定為 true 以關閉成功通知。
- `NOTICE_ON_SUCCESS`: **false**: 設定為 true 以打開成功通知。
- `SCHEDULE`: **@every 6h**: Cron 語法,用於設定檢查的頻率。
#### Cron - 啟動基於定時的 Actions (`cron.start_schedule_tasks`)
- `ENABLED`: **true**: 啟用服務。
- `RUN_AT_START`: **false**: 在啟動時運行任務(如果啟用)。
- `NO_SUCCESS_NOTICE`: **false**: 設定為 true 以關閉成功通知。
- `NOTICE_ON_SUCCESS`: **false**: 設定為 true 以打開成功通知。
- `SCHEDULE`: **@every 1m**: Cron 語法,用於設定調度任務的頻率。
## Git (`git`)