bircni
d4d211273a
Merge remote-tracking branch 'origin/main' into docs-artifact-previews
2026-09-26 23:28:32 +02:00
bircni
a90b007dd7
update
2026-09-26 23:28:25 +02:00
silverwind
c4caf767ad
docs: document self:, builtin:, $/ and runner tracing ( #553 )
...
Documents the `self:` and `builtin:` action prefixes from https://github.com/go-gitea/gitea/pull/39358 , https://gitea.com/gitea/runner/pulls/1233 and https://gitea.com/gitea/runner/pulls/871 , workflow-relative `$/` actions, and the runner's OpenTelemetry tracing from https://gitea.com/gitea/runner/pulls/1206 .
1. Trims the action resolution and `DEFAULT_ACTIONS_URL` docs to state each fact once.
1. Drops outdated runner content from the FAQ and design pages.
1. Syncs zh-cn and zh-tw, including a port of the token permissions page they now link to.
_Written by Claude._
Reviewed-on: https://gitea.com/gitea/docs/pulls/553
Reviewed-by: bircni <[email protected] [email protected]
2026-09-25 02:51:09 +00:00
silverwind and Lunny Xiao
24a7eb79e5
Document GITEA_DOCKER_WORKSPACE ( #535 )
...
Documents the variable added in https://gitea.com/gitea/runner/pulls/1204 and drops the `valid_volumes` requirement for `bind_workdir`, gone since https://gitea.com/gitea/runner/pulls/1203 .
Assisted by Claude (Fable 5.1).
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/535
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-09-08 18:26:25 +00:00
bircni
5e973abb6e
add artifact preview
2026-08-30 14:23:03 +02:00
wxiaoguang
ca655edaf1
Support .gitea/default_merge_message/DEFAULT_TEMPLATE.md for default message ( #491 )
...
https://github.com/go-gitea/gitea/pull/38803
Reviewed-on: https://gitea.com/gitea/docs/pulls/491
Reviewed-by: silverwind <[email protected] [email protected]
2026-08-07 13:41:18 +00:00
Lunny Xiao
a1ef3a26ef
Remove duplicated runner docs ( #479 )
...
The `usage/actions/runner` has duplicated runner documentations as `/runner`. This PR remove the duplicated content and leave obtain registry token in `usage/actions/runner` and runner install/configurations in `/runner`.
Reviewed-on: https://gitea.com/gitea/docs/pulls/479
Reviewed-by: silverwind <[email protected]
2026-08-02 21:53:31 +00:00
silverwind
8bcba04001
Document gitea.event payload fields ( #478 )
...
Fixes https://gitea.com/gitea/docs/issues/386
`gitea.event` was documented as `{...}` only. Adds an "Event payload" section listing the commonly used fields per event, including `gitea.event.schedule`, and notes where Gitea's payloads deviate from GitHub's.
Also corrects the trigger event table:
1. `pull_request` takes `synchronize`, not `synchronized`
1. `workflow_run` also emits `in_progress`
1. `schedule`, `workflow_call` and `pull_request_target` were missing
Reviewed-on: https://gitea.com/gitea/docs/pulls/478
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-08-02 21:07:13 +00:00
49dcc71f89
fix: AGit docs accurately reflect syntax ( #474 )
...
there was confusing words around this. `HEAD` was mentioned twice and `origin` was used in place of a sensible option
---------
Co-authored-by: MnPX <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/474
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-08-02 17:48:09 +00:00
7b8a06864f
Add documentation for code owner branch protection ( #245 )
...
Documentation for https://github.com/go-gitea/gitea/pull/34995
---------
Co-authored-by: bircni <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/245
Reviewed-by: bircni <[email protected] [email protected]
2026-07-31 12:50:43 +00:00
wxiaoguang
199e9a2284
repo template supports "exclude" ( #470 )
...
https://github.com/go-gitea/gitea/pull/38064
2026-07-24 16:31:45 +00:00
SudhanshuSingh
53596559be
docs: update runs-on expression support in comparison guide ( #462 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/462
Reviewed-by: wxiaoguang <[email protected] [email protected]
2026-07-12 11:27:00 +00:00
Nicolas
7aae398e37
docs: Update as we now support continue-on-error in 1.27 ( #452 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/452
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-01 03:20:59 +00:00
Zettat123 and Lunny Xiao
1fb481c186
docs: add docs for scoped workflows ( #447 )
...
Related: https://github.com/go-gitea/gitea/pull/38154
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/447
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-06-28 09:32:51 +00:00
Nicolas and Lunny Xiao
eb65e671a2
Runner docs v1.0.8 ( #435 )
...
Adds a versioned docs snapshot for Gitea Runner v1.0.8 (latest stable),
updates lastVersion and navbar to point to the new version while keeping
0.2.11 in the dropdown for historical reference.
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/435
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-06-14 00:30:30 +00:00
nico-i
eb5204f658
Added project config to issue template example ( #428 )
...
I have updated the docs since this feature is now supported.
Reviewed-on: https://gitea.com/gitea/docs/pulls/428
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-05-29 16:52:56 +00:00
harryzcy and Chongyi Zheng
69e92d33ec
docs: update conan login command for conan v2 ( #426 )
...
Conan v1 reached end-of-life. https://blog.conan.io/2024/09/30/Conan-Center-will-stop-receiving-updates-for-Conan-1.html
The command for conan v2 login has changed to `conan remote login`. https://docs.conan.io/2/reference/commands/remote.html#conan-remote-login
I briefly looked at Gitea codebase. Gitea supports conan v2 cli (given functions like `DeleteRecipeV2` and `SearchPackagesV2`)
---------
Co-authored-by: Chongyi Zheng <[email protected] https://gitea.com/gitea/docs/pulls/426
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-05-26 07:53:05 +00:00
54af905d63
rename act runner to runner ( #390 )
...
Depends on gitea/runner#850
---------
Co-authored-by: Nicolas <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/390
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2026-05-07 17:18:58 +00:00
Lunny Xiao
14b76120b4
update webhook documentation ( #393 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/393
2026-05-01 16:40:27 +00:00
0xGREG and Nicolas
e0fcc861f2
Document DEFAULT_TITLE_SOURCE pull request title setting ( #391 )
...
Adds documentation for the `DEFAULT_TITLE_SOURCE` setting.
- Added `DEFAULT_TITLE_SOURCE` to the config cheat sheet under `[repository.pull-request]`
- Added a "Default pull request title" section to the pull request usage docs explaining both modes (`first-commit` and `auto`)
---------
Co-authored-by: Nicolas <[email protected] https://gitea.com/gitea/docs/pulls/391
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-04-28 21:45:22 +00:00
silverwind
5e4cd3b577
Remove obsolete actions concurrency notes ( #377 )
...
`concurrency` is fully supported as of v1.26 via https://github.com/go-gitea/gitea/pull/32751 , so remove the unsupported entry and the different-behavior note.
Closes #340
---
This PR was written with the help of Claude Opus 4.6
Reviewed-on: https://gitea.com/gitea/docs/pulls/377
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-04-08 23:08:20 +00:00
TheFox0x7
1568bfa1e9
terraform state registry docs ( #357 )
...
https://github.com/go-gitea/gitea/pull/36710
Reviewed-on: https://gitea.com/gitea/docs/pulls/357
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-04-06 20:41:42 +00:00
wxiaoguang
efa6607558
GitHub-like theme-based image display ( #372 )
2026-04-03 18:25:12 +00:00
silverwind
25dce1df62
Add pre-defined variables reference to Actions docs ( #369 )
...
Add comprehensive reference tables for pre-defined variables available in Gitea Actions workflows, derived from the Gitea and act_runner source code.
## Context variables (`${{ gitea.<name> }}`)
All context variables with their `github.*` aliases and descriptions, sourced from `services/actions/context.go`.
## Environment variables
- **Standard**: `CI`, `GITEA_ACTIONS`, `GITEA_ACTIONS_RUNNER_VERSION`, `GITHUB_*`, and the 5 `GITEA_*` aliases for workflow file commands (`GITEA_ENV`, `GITEA_OUTPUT`, `GITEA_PATH`, `GITEA_STATE`, `GITEA_STEP_SUMMARY`)
- **Runner**: `RUNNER_OS`, `RUNNER_ARCH`, `RUNNER_TEMP`, `RUNNER_TOOL_CACHE`
- **Internal**: `ACTIONS_CACHE_URL`, `ACTIONS_RUNTIME_*`, etc.
Closes https://gitea.com/gitea/docs/issues/350
Reviewed-on: https://gitea.com/gitea/docs/pulls/369
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-03-28 09:27:06 +00:00
Excellencedev
0c17ed264d
Add docs for configurable permissions for Actions automatic tokens ( #366 )
...
Docs for https://github.com/go-gitea/gitea/pull/36173
Reviewed-on: https://gitea.com/gitea/docs/pulls/366
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected] [email protected] [email protected]
2026-03-24 11:11:25 +00:00
crrdean
6cd29ccce0
Fixed pull_request action name ( #359 )
...
synchronize should be synchronized
Reviewed-on: https://gitea.com/gitea/docs/pulls/359
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2026-03-10 20:00:25 +00:00
osndok and Robert Hailey
2b96323137
Note differing default value for concurrency.cancel-in-progress ( #337 )
...
Whereas this bit me pretty hard, and [I don't seem to be the only one](https://forum.gitea.com/t/job-stopping-on-new-push/8142 ), the least we could do is let people know.
---------
Co-authored-by: Robert Hailey <[email protected] https://gitea.com/gitea/docs/pulls/337
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-02-08 03:08:05 +00:00
Peter Ryszkiewicz
8a40822acd
Fix act runner doc typos and errors and simplify some grammar. ( #328 )
...
Fix act runner doc typos and errors and simplify some grammar.
Co-authored-by: Peter Ryszkiewicz <[email protected] [email protected]
2026-02-03 00:52:06 +00:00
072331ecae
Clarify package permissions and tokens scopes as discussed in https://github.com/go-gitea/gitea/issues/32048 ( #72 )
...
This adds explanations, that were missing regarding Token scopes and the packages feature requiring a token with said scope. Also added a missing explanation, that tokens can be created in the user interface, not just the API. The reason this PR is created was due to misunderstandings around the package feature, that arose during the discussion in https://github.com/go-gitea/gitea/issues/32048 .
This PR aims to clarify the misunderstood points around tokens, scopes and the package feature.
During the creation of this PR bug https://github.com/go-gitea/gitea/issues/32078 was found, the scopes are always reported as `null` during the response of the initial `POST` to create the token.
Co-authored-by: Wladislav ヴラド Artsimovich <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/72
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-11-20 22:16:00 +00:00
Lunny Xiao
df8b7a7581
Upgrade docusarus and fix broken links ( #301 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/301
2025-11-20 22:02:05 +00:00
Schallbert
0868bd41a4
Minor update for act_runner documentation: Update execution options, clarify docker run ( #256 )
...
- add act_runner options (host, docker, DinD)
- modify `docker run` command to include volume
- minor formulation updates
Reviewed-on: https://gitea.com/gitea/docs/pulls/256
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-11-20 21:52:54 +00:00
Zettat123 and Lunny Xiao
2b99f48d47
Share actions and reusable workflows from private repositories ( #107 )
...
Update docs for https://github.com/go-gitea/gitea/pull/32562
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/107
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-11-20 19:57:50 +00:00
Lunny Xiao
9baa98ec3f
Move usage directories ( #300 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/300
2025-11-20 19:49:24 +00:00
Lunny Xiao
c05b0cec34
Add protected branches usage documentation ( #298 )
...
Fix https://github.com/go-gitea/gitea/issues/35972
Reviewed-on: https://gitea.com/gitea/docs/pulls/298
2025-11-20 18:07:29 +00:00
Lunny Xiao
dcb9b9b450
Use category instead of place holder markdown file as directory ( #299 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/299
2025-11-20 18:02:34 +00:00
Cory Sanin and Lunny Xiao
a77b0937cf
Corrections for Arch package registry page ( #291 )
...
pairs nicely with https://github.com/go-gitea/gitea/pull/35825
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/291
Reviewed-by: silverwind <[email protected] [email protected] [email protected]
2025-11-05 17:26:38 +00:00
dangjinghao
0c7fce4512
Remove run-name section from Comparison to GitHub Actions ( #290 )
...
Since `run-name` support was added in [v1.25.0](https://github.com/go-gitea/gitea/releases/tag/v1.25.0 ), I've removed the outdated `run-name` section from `usage/actions/comparison.md`.
Reviewed-on: https://gitea.com/gitea/docs/pulls/290
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-11-01 21:11:55 +00:00
dangjinghao
bb7b7fe5bf
Add frontmatter and TOC rendering support for markdown files ( #284 )
...
<https://github.com/go-gitea/gitea/issues/14411#issuecomment-764871702 >
Reviewed-on: https://gitea.com/gitea/docs/pulls/284
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-10-23 17:55:14 +00:00
Christopher Homberger and Lunny Xiao
cf33eee47f
Initial Ephemeral Runners Documentation ( #239 )
...
Document this feature for 1.24 onwards.
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/239
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-07-28 20:40:59 +00:00
Christopher Homberger and Lunny Xiao
201f0f3ef8
Document workflow_dispatch workflow_run ( #238 )
...
Document missing workflow triggers of 1.23..1.25-dev
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/238
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-07-28 20:39:01 +00:00
dmitri.karpovich
f58dfff5e4
Update docs/usage/actions/quickstart.md ( #222 )
...
Fix typo
Reviewed-on: https://gitea.com/gitea/docs/pulls/222
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2025-05-26 00:07:58 +00:00
bytedream
df3f3f8dab
Action badge style query ( #209 )
...
Add dcos for the new style query for action badges (https://github.com/go-gitea/gitea/pull/34062 ).
Reviewed-on: https://gitea.com/gitea/docs/pulls/209
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-04-13 17:54:09 +00:00
juke and Jules Kerssemakers
1a85ffdab8
Expand new Usage/Markdown Docu ( #203 )
...
As promised in [Gitea Pull #34105 ](https://github.com/go-gitea/gitea/pull/34105 ), I wanted to contribute documentation for MarkDown.
You were so fast in adding the page that I had to start over my local-only draft 😄 🚀
I'm not sure how you prefer your commits (I'm new to Gitea), so I've split them for simplest review and dropping of unwanted changes.
Co-authored-by: Jules Kerssemakers <[email protected] https://gitea.com/gitea/docs/pulls/203
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-04-10 20:15:37 +00:00
wxiaoguang
e3d58503ca
Add markdown usage ( #198 )
...
First simple version
Reviewed-on: https://gitea.com/gitea/docs/pulls/198
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-04-05 05:08:06 +00:00
techknowlogick
714b9dd6b7
fix launchctl example
...
thanks for #183 that reported and fixed this issue in versioned docs
2025-03-14 02:14:01 +00:00
TheFox0x7
eaeb29f827
Add warning about actions under subpath ( #176 )
...
in reference to: https://github.com/go-gitea/gitea/issues/33629
Reviewed-on: https://gitea.com/gitea/docs/pulls/176
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2025-03-02 17:52:04 +00:00
Lunny Xiao
bbbb9091bf
Update act runner status ( #163 )
...
Fix #162
Reviewed-on: https://gitea.com/gitea/docs/pulls/163
Co-authored-by: Lunny Xiao <[email protected] [email protected]
2025-01-29 05:12:05 +00:00
Brandon Philips
59ef598b49
fix admin url for 1.23.0 ( #164 )
...
I am running the release candidate and found the admin URL changed.
https://github.com/go-gitea/gitea/pull/32189
Reviewed-on: https://gitea.com/gitea/docs/pulls/164
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2025-01-28 16:33:32 +00:00
woshishabii
56cbea7928
a typo i guess ( #155 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/155
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2025-01-16 00:16:26 +00:00
Zettat123
a97908040d
Update some docs ( #144 )
...
Close #143
- Add `ORG_PAGING_NUM`
- Remove `hashFiles` from unsupported workflows syntax
Reviewed-on: https://gitea.com/gitea/docs/pulls/144
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2025-01-09 05:27:03 +00:00
bircni
silverwind
silverwindandLunny Xiao
wxiaoguang
SudhanshuSingh
Zettat123andLunny Xiao
nico-i
harryzcyandChongyi Zheng
0xGREGandNicolas
TheFox0x7
Excellencedev
crrdean
osndokandRobert Hailey
Peter Ryszkiewicz
Schallbert
Cory SaninandLunny Xiao
dangjinghao
Christopher HombergerandLunny Xiao
dmitri.karpovich
bytedream
jukeandJules Kerssemakers
wxiaoguang
techknowlogick
TheFox0x7
Brandon Philips
woshishabii