Earl Warren
d1662f520e
developer: infrastructure: blacklist bots that do not obey robots.txt
...
They get /forgejo/forgejo/archive/100448a007707c049a769cb71cd170fcb5b64a25.bundle
despite https://code.forgejo.org/robots.txt having
Disallow: /*/*/archive/
Disallow: /*/*/archive/*.bundle
2024-04-15 10:38:55 +00:00
Christian Drexler
798fee5b11
small update to docker compose (quoted boolean, compose as module) (again) ( #525 )
...
Hi,
somehow I made a hash of the last PR #522 so it failed linting again. I hope it is ok now. Sorry for the noise!
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/525
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Christian Drexler <xunzi@noreply.codeberg.org>
Co-committed-by: Christian Drexler <xunzi@noreply.codeberg.org>
2024-04-14 12:31:01 +00:00
0ko
b4354d111a
Developer: Base localization: add Contributing section
2024-04-11 14:43:22 +00:00
oliverpool
cc1a240739
webhooks: add SourceHut Builds and matrix, organize by type
2024-04-10 17:36:35 +02:00
natct
c134c1bb09
Badges are enabled by default.
2024-04-10 11:28:01 +02:00
natct
e0200e8b3c
Add Repository Activity.
2024-04-10 10:06:04 +02:00
jilen
81154d6fa5
add minio bucket lookup
2024-04-10 07:09:11 +02:00
Ada
53da12e153
Improve wording
2024-04-05 22:11:28 +02:00
Ada
a2824865fa
add documentation for cron.delete_inactive_accounts
2024-04-05 21:26:12 +02:00
Mai-Lapyst
b47946be04
Document the new preview of permalinks
2024-04-05 04:21:34 +00:00
Earl Warren
e686086717
developer: dependency management guide
2024-04-03 09:53:18 +00:00
Gergely Nagy
6398dc14de
Revert "admin: Document [repository].DOWNLOAD_OR_CLONE_METHODS"
...
This reverts commit 28cdb8ca82
2024-04-01 22:13:00 +02:00
0ko
23cee48c5b
config: socks are socks5
...
Ref https://codeberg.org/forgejo/forgejo/issues/2943
2024-04-01 19:00:10 +05:00
Shiny Nematoda
e6d29aec71
user: update code search
2024-03-31 08:02:55 +00:00
Earl Warren
0c64312770
developer: release: update from cutting the v7.0 branch
...
Refs: https://codeberg.org/forgejo/forgejo/issues/2425
2024-03-30 15:36:18 +01:00
Earl Warren
76562da938
LTS EOL must overlap the next LTS
2024-03-30 08:19:44 +00:00
Earl Warren
73e569c299
user: release: LTS support
2024-03-30 08:19:44 +00:00
Pi-Cla
3693fe0926
Mention code.forgejo.org mirror
...
The docker installation page does not link to the download
page so we should also mention the mirror here
2024-03-27 16:28:10 -06:00
Earl Warren
8f79cbc4ce
docs: developer: forgejo-backport-action
...
Refs: https://codeberg.org/forgejo/forgejo/issues/2725
2024-03-25 23:03:59 +00:00
Earl Warren
9c64779735
docs: developer: forgejo-renovate-action
...
Refs: https://codeberg.org/forgejo/forgejo/issues/2765
2024-03-24 14:23:39 +01:00
0ko
8dd6e0fbcf
I18N: update language dict
2024-03-23 19:28:12 +05:00
Bao Trinh
ff3d0ddea6
admin: logging-documentation: fix inaccuracies
2024-03-21 07:47:39 -05:00
cascading-pr
a9205a81e9
cascading-pr update
2024-03-20 14:51:43 +00:00
Earl Warren
b5c7a08a99
developer: localization: workflow for PR that modify translations
2024-03-20 08:34:19 +01:00
Panagiotis "Ivory" Vasilopoulos
02aa6e323b
Capitalize titles of guide index pages
2024-03-17 20:50:02 +01:00
Mai-Lapyst
89d977a913
Fixes a typo for steps in workflows
...
...where the 'steps' key of jobs is documented as 'step'
2024-03-16 02:45:22 +00:00
rom4nik
206ed546b9
developer/infrastructure.md: ephemral -> ephemeral
2024-03-16 02:44:22 +00:00
Mai-Lapyst
d6dca55482
Document jobs.<job_id>.steps[*].env
2024-03-15 08:50:21 +01:00
0ko
fe8a889cf4
developer: add Base localization guide
2024-03-11 18:00:00 +05:00
Rik Huijzer
05f8dd4b77
admin: clarify the Runner label keyword ( #475 )
...
It was quite painful yesterday to try to figure out why my workflow didn't work anymore after the Forgejo migration. Turns out that `gitea/act_runner` used a different default Docker image. With this PR, it should be clearer to other people what is the meaning of the labels.
Co-authored-by: Rik Huijzer <github@huijzer.xyz>
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/475
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Rik Huijzer <rikh@noreply.codeberg.org>
Co-committed-by: Rik Huijzer <rikh@noreply.codeberg.org>
2024-03-10 06:29:20 +00:00
Rik Huijzer
4ff026d3ed
admin: add a Docker Compose runner example ( #474 )
...
This PR extends the examples that were provided by @earl-warren in https://codeberg.org/forgejo/runner . I've tested this configuration twice today on two completely separate servers. For more information about the whole process that I've used, see https://huijzer.xyz/posts/forgejo-setup/ .
I'll try to extract upstream a bit more information to the Forgejo docs. Feel free to take anything from my blog that seems useful and don't worry about credits. Feel free to copy whatever seems useful.
Co-authored-by: Rik Huijzer <github@huijzer.xyz>
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/474
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Rik Huijzer <rikh@noreply.codeberg.org>
Co-committed-by: Rik Huijzer <rikh@noreply.codeberg.org>
2024-03-09 03:50:55 +00:00
Rik Huijzer
7a66846f4a
Incorporate feedback
...
Co-authored-by: Earl Warren <contact@earl-warren.org>
2024-03-08 07:24:05 +01:00
Rik Huijzer
1288f10550
Fix lint issue
2024-03-07 18:21:29 +01:00
Rik Huijzer
345765e21f
Add rootless installation instructions
2024-03-07 17:04:47 +01:00
Gusted
3886dc485b
admin: move Gitea migration to its own page
...
It doesn't feel right to have such guide on the installation page, it
feels more natural to have it's own page. This also keeps the
'installation' page clean, which currently feels more like an index
page, given it's linking to two other pages (installation from {binary,docker}).
2024-03-07 11:13:53 +00:00
Earl Warren
33d2622dff
developer: set the tag of the built image
...
Otherwise it won't show in `docker image ls` which can be confusing.
2024-03-06 14:31:31 +08:00
0ko
3f9b7ac809
localization: more information for team applicants
2024-03-05 13:41:44 +05:00
Earl Warren
920b0e97fd
update admin & user guide with semantic versioning
...
* Explain how the semantic version relate to the API
* Update the admin guide terminology
* Add a legacy section in the user reference guide
2024-03-02 20:41:58 +08:00
inference
8e7aa6b332
Semantic Versioning Updates ( #460 )
...
Preview: https://forgejo.codeberg.page/@docs_pull_460/docs/next/user/semver/
---
This pull request updates the Semantic Versioning mentions in the Forgejo documentation, as discussed in [forgejo/forgejo #2459 ](https://codeberg.org/forgejo/forgejo/pulls/2459 ).
It is currently a draft and feedback on how to approach this is appreciated. I think the Forgejo v1.19 section should be renamed to "legacy" or at least mention it due to it being the legacy versioning scheme, and moved below the new SemVer-compliant scheme. You can see how I've done that myself on [my website](https://inferencium.net/about.xhtml#versioning-numbering_scheme ) for a taste of how it would look to a user.
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/460
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: inference <admin@inferencium.net>
Co-committed-by: inference <admin@inferencium.net>
2024-03-02 10:54:49 +00:00
Earl Warren
937e55acc0
developer: releases: replace X.Y.Z+A.B.C with X.Y.Z+gitea-A.B.C
...
Followup of https://codeberg.org/forgejo/forgejo/pulls/2514
2024-03-02 10:31:08 +00:00
cascading-pr
87e204a528
cascading-pr update
2024-03-01 01:03:14 +00:00
Shiny Nematoda
6cc672040b
admin: Document fallback behavior of repo indexer ( #444 )
...
ref: https://codeberg.org/forgejo/forgejo/pulls/1594
Preview: https://forgejo.codeberg.page/@docs_pull_444/docs/next/user/code-search/
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/444
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Shiny Nematoda <snematoda@noreply.codeberg.org>
Co-committed-by: Shiny Nematoda <snematoda@noreply.codeberg.org>
2024-02-29 15:06:38 +00:00
Earl Warren
42d27fe502
developer: localization: warn before locking
2024-02-28 11:35:14 +01:00
Earl Warren
0127a9b0a4
developer: infrastructure: check for next.forgejo.org upgrades hourly
2024-02-27 12:41:31 +01:00
Andre601
da8202b897
User: Update info on configuring auth for maven package
2024-02-26 15:24:18 +00:00
Earl Warren
7dee6e6060
developer: infrastructure: no need for Enough, use ssh instead
...
It lowers the learning curve a little more for future sysadmins.
Also remove the obsolete hardware paragraph in the code.forgejo.org
page.
2024-02-26 14:18:39 +00:00
Earl Warren
09dfcc4ec0
sync with Codeberg 85d333f48badb27f8e4371263db3354f70836dfd
...
https://codeberg.org/Codeberg/Documentation
git diff 7bb8fa5ca559073c028805888195ee31b1f3d9c2..85d333f48badb27f8e4371263db3354f70836dfd > doc.patch
2024-02-25 18:03:50 +00:00
Earl Warren
24def40ad3
sync with Gitea d3982bcd814bac93e3cbce1c7eb749b17e413fbd
...
git diff abe8fe352711601fbcd24bf4505f7e0b81a93c5d..d3982bcd814bac93e3cbce1c7eb749b17e413fbd -- $(find . -type f -name '*en-us*')
2024-02-25 18:03:28 +00:00
Earl Warren
f9702d46cd
developer: infrastructure: next.forgejo.org auto-upgrades
2024-02-24 23:11:36 +01:00
Earl Warren
62c3b2540b
developer: release: the version metadata is not in the tag
...
It is added to the version when building it but is not part of the
release name.
Refs: https://codeberg.org/forgejo/forgejo/pulls/2459
2024-02-24 14:11:02 +01:00
Gusted
aa48cb3b99
admin: Add ambiguous character detection config
...
- Ref: https://codeberg.org/forgejo/forgejo/pulls/2427
2024-02-24 12:25:53 +00:00
Marko Korhonen
8bc412af4c
Fix typo
2024-02-24 11:19:09 +02:00
Earl Warren
6bb6309a4e
developer: release process update for the hard fork
...
* Release number is v7.0.0+1.22.0 and following semantic versioning
* Remove the workflow page which is no longer needed as:
* it is implicitly understood pull requests go to the default branch
* testing requirements are documented in the testing.md page
* Explain how to cut a release and set the tag in forgejo-integration
for proper numbering of the test releases that come out of the
development branch
Refs: https://codeberg.org/forgejo/forgejo/pulls/2448
2024-02-23 16:53:01 +01:00
Earl Warren
299a3a2951
developer: testing: split this section out of compilation
2024-02-21 23:41:46 +01:00
Earl Warren
a50d5e1f00
developer: localization: admin duties
...
after a few rounds of merging translations the checklist is slightly
different
2024-02-21 14:39:50 +01:00
Gusted
162f0ad25c
admin: add new option to config cheat sheet
...
- Ref: https://codeberg.org/forgejo/forgejo/pulls/2418
2024-02-21 11:55:43 +01:00
Gusted
a4e1851ff2
user: Clarify value of force-push in AGit
...
- Clarify that if you want to use this parameter the value should be set
to `true` (other values may work, but that can be restricted later).
- Ref: https://codeberg.org/forgejo/forgejo/pulls/2386#issuecomment-1572905
2024-02-19 13:30:51 +01:00
Otto Richter
bd2e86a799
Drop support for Microsoft SQL Server
2024-02-18 20:51:58 +01:00
Panagiotis "Ivory" Vasilopoulos
d12a9fee60
admin/customization: No need to be a developer for custom branding ( #427 )
...
Preview: https://forgejo.codeberg.page/@docs_pull_427/docs/next/admin/customization/
---
The previous version of this document insinuated that you need to be
familiar with Forgejo's source code and compile Forgejo from source
for custom branding changes. As of the most recent Forgejo version,
this is not necessarily true, as custom files can be served from
the CustomPath.
Administrators that were not developers therefore dismissed the
other guide and its contents without reading this, and I was one
of them. I thought it would make sense for this file to provide
information on where to put a custom logo. This change does not
fix it (this will be done later), but it will reduce the confusion
for now.
This warning confused me personally and other Forgejo users, as I
had one person tell me IRL that they thought that it was not possible
to serve a custom logo.
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/427
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-committed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2024-02-18 17:22:54 +00:00
François Kooman
29d9296d14
clarify which reverse proxy configuration fields need to be under [security]
2024-02-18 15:29:33 +00:00
Panagiotis "Ivory" Vasilopoulos
6c755e61f4
developer/customization: use example.com example domain
2024-02-18 15:28:10 +00:00
Slatian
4b8db5a048
In issue-pull-request-template documentation, deduplicate contact link name key
...
The Table under "Contact Link" has two rows labeled `name` with exactly the same content, it should only occur once.
2024-02-18 12:40:05 +00:00
Earl Warren
c81c50daa4
admin: installation: v1.21 is current
2024-02-17 11:40:29 +01:00
Panagiotis "Ivory" Vasilopoulos
d0acbd9821
Change topic branch example to avoid confusion
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
19be4452a0
Clarify the differences between session and topic better
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
89c17ef6a7
fix small markdown error
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
a927273363
retrospectively -> retroactively
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
c71eebd1da
OK, I know I said that I'd drop this for now like a thousand times
...
... but there was this sentence that I just read again and
it annoyed me :(
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
18df26e318
Change title to 'AGit Workflow Usage'
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
bef6fc5197
topic -> topic
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
ff08aab827
topic is optional when <session> exists
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
7063f466bc
remove half-finished line
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
037209620b
change order of push options
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
aa03b7e78c
small language improvements
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
6472e357b7
'For clarity reasons' instead of 'For reasons of clarity'
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
1493478a2a
Reiterate caveats, again
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
86a01ada3a
Capitalization error, s/instructions/information
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
27f930aeb7
wrong "
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
b0dadbd6c5
\
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
0cf21c22c5
Clean things up, address review comments
...
- Improve background information
- Move Caveat information to parameter explanations
- Add <session> example
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
389a056329
improve typo
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
c3ed73b805
fix typo
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
4f96b73679
improve topic stuff, break examples into multiple lines
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
7c3ba56acb
add information for gerrit users, improve caveats
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
45bc09ace6
improve background information and examples
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
96ee352885
fix error in example
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
6e1950122e
add git internals book reference
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
6de8961922
add remark about empty titles
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
35011cb8f7
user: agit: improve clarity
...
- Improve introductory paragraph
- Explain Agit's use cases briefly
- Add required parameter markers
- Explain caveats
- Minor grammar improvements
2024-02-13 11:21:47 +00:00
Earl Warren
c7dbb76caa
admin: cheat-cheat: [cache].HOST redis+sentinel
...
Fixes: https://codeberg.org/forgejo/docs/issues/380
2024-02-12 13:35:23 +00:00
Earl Warren
73d1ff084b
developer: infrastructure: code.forgejo.org upgrade checklist
...
instead of keeping a backup within the container itself, trigger the
backup external to the container to make sure it reflects the state of
the container after Forgejo is shutdown in case it needs to be
retrieved.
2024-02-11 09:24:45 +01:00
Earl Warren
930201f2cc
developer: workflow: hard fork update
...
features branches are not necessary now that Forgejo is a hard fork
2024-02-09 23:18:43 +01:00
Earl Warren
ae8ef872e3
developer: localization: document admin duties
2024-02-09 18:40:49 +01:00
Earl Warren
b023ac6a9b
developer: workflow: manual testing expectations
...
Refs: https://codeberg.org/forgejo/discussions/issues/100#
Refs: https://codeberg.org/forgejo/forgejo/pulls/2265
2024-02-08 11:36:51 +00:00
Gergely Nagy
2b0bd8d011
user/profile: Document how to add rel=me social links
...
Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2024-02-07 19:40:04 +00:00
0ko
ba0900a4e0
developer: update localization guide about edit access
2024-02-08 00:11:39 +05:00
Gusted
e20aa2bfa7
user: fix 404 link
...
Resolves #404
2024-02-04 13:47:27 +00:00
Earl Warren
2288a5dc4e
developer: compile from source
...
* hint to use `make help` for target information
* require Go v1.21
* remove some redundant / obsolete strings
* `TAGS='sqlite sqlite_unlock_notify' make watch` because it is not
much use without sqlite
2024-02-03 18:59:08 +01:00
0ko
8607413816
developer: s/VS Codium/VSCodium
2024-02-03 14:16:09 +00:00
0ko
366609cfa9
Update localization team application ways ( #394 )
...
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/394
Co-authored-by: 0ko <0ko@noreply.codeberg.org>
Co-committed-by: 0ko <0ko@noreply.codeberg.org>
2024-01-28 15:12:54 +00:00
Earl Warren
5079065aee
user: actions: add sample events for schedule
2024-01-24 20:19:23 +01:00
cascading-pr
e8c24ff988
cascading-pr update
2024-01-24 19:03:59 +00:00
Gusted
62c52bbcb8
config: Fix typo
...
- Ref: https://codeberg.org/forgejo/forgejo/pulls/2226
2024-01-24 16:58:40 +01:00
Earl Warren
4a8628a003
user: packages: move storage section to the index
...
The storage page was not referenced and could not be found.
2024-01-24 15:18:36 +00:00
lennybacon
cc20e1b840
Fixed the path
...
The app.ini is in `/etc/forgejo`.
2024-01-23 17:23:32 +00:00
0eoc
eebf84ef7d
developer: add localization contribution guide
2024-01-23 18:13:40 +01:00
Earl Warren
808f85e05f
admin: command-line: VERSION has variance, dont use it
2024-01-23 18:09:28 +01:00
Gergely Nagy
a126811a15
user: Document how repo language detection works
...
Addresses Codeberg/Community#1391 .
Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2024-01-18 16:21:02 +00:00
Gergely Nagy
a71e07f71f
user: Document README badges
...
Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2024-01-14 21:25:31 +01:00
Gergely Nagy
bdc5a11431
admin: Document Badges on the cheat sheet
...
Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2024-01-14 19:11:06 +01:00
Earl Warren
b75189c25c
user: actions: add sample events for on.push
2024-01-13 20:17:53 +00:00
cascading-pr
cfc736e465
cascading-pr update
2024-01-13 19:00:31 +00:00
Earl Warren
3905e7f466
user: actions: on.push
2024-01-13 18:27:52 +01:00
Earl Warren
280ed98b44
developer: release: code.forgejo.org/forgejo/forgejo mirror
2024-01-13 15:28:39 +00:00
houkime
195d7dfda1
add how to run autotests
2024-01-13 10:38:57 +00:00
Earl Warren
33c3156197
user: actions: inputs context, containers & services
2024-01-10 21:42:16 +01:00
Earl Warren
71f88953fd
user: actions: steps context
2024-01-10 19:51:05 +01:00
Earl Warren
5a574a8d24
user: actions: jobs.<job_id>.strategy.matrix
2024-01-10 19:16:02 +01:00
Gergely Nagy
28cdb8ca82
admin: Document [repository].DOWNLOAD_OR_CLONE_METHODS
...
Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2024-01-10 17:24:41 +00:00
Earl Warren
db2287aa1b
user: actions: fix 404 link
...
s|fork|fork-org|
2024-01-10 15:02:55 +01:00
Gergely Nagy
4f084a59a3
user: Document globally editable wikis
...
Document the `Allow anyone to edit the Wiki` option in `Settings`, and
the consequences of activating it.
Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2024-01-10 10:04:39 +01:00
Earl Warren
f999b399bf
user: actions: add github context
...
With event examples for pull requests
Fixes: https://codeberg.org/forgejo/docs/issues/345
2024-01-09 23:51:38 +01:00
cascading-pr
b6af104871
cascading-pr update
2024-01-09 20:16:13 +00:00
Earl Warren
cc82968347
developers: https://codeberg.org/forgejo-cascading-pr
...
A user dedicated to create PRs on behalf of other Forgejo repositories.
2024-01-07 20:48:40 +01:00
Earl Warren
db43b68f0e
developer: RELEASE: the forgejo-ci user was for Woodpecker CI
...
it is no longer in use and was deleted
2024-01-07 17:27:44 +01:00
Earl Warren
4ab4393b42
user: actions: contexts and environment variables
2024-01-07 14:48:30 +01:00
Earl Warren
cb05660c81
admin: CLI: generate from --help
...
because the output of `forgejo docs` is unusable
2023-12-31 17:02:46 +01:00
Earl Warren
cfa5760e60
developer: infrastructure: upgrade and re-install octopuce
...
* switch to using lxc-helpers alone instead of enough
the learning curve of
[enough](https://enough-community.readthedocs.io ) is an unecessary
burden in this context. Manual installation with lxc-helpers and
documentation is enough when there only is a need for a handful
of manual intervention per year
* update the Forgejo runner installation instructions
* tested the docker + self-hosted label to work with a test workflow
* do not maintain and setup a self-signed certificate because it creates a
complication that is unecessary when behind a VPN
2023-12-28 17:18:25 +01:00
Gergely Nagy
5958b3a618
admin: database: Suggest a better collation for MySQL
...
In `admin/database-preparation` suggest `utf8mb4_bin` as the collate
function, rather than `utf8mb4_unicode_ci`. The former is accent- and
case sensitive, while the latter isn't, and Forgejo assumes that columns
are case sensitive.
Also add a short paragraph explaining why `utf8mb4_bin` is
suggested (case sensitivity), and what problems may arise and why if
case insensitive collation is used.
This partially addresses forgejo/forgejo#2039 .
Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2023-12-28 11:46:34 +01:00
Earl Warren
cc4162ecb8
admin: actions: 3.3.0 is now the default
2023-12-27 18:43:10 +01:00
Earl Warren
fb303e8a04
COC: link to the moderation team
2023-12-27 18:35:08 +01:00
Earl Warren
23e8feae22
developer: link to the governance repository
2023-12-26 14:20:05 +01:00
Earl Warren
55dedc4ba6
developer: link to the governance repository
2023-12-25 23:29:41 +00:00
Earl Warren
1caecddf18
{developer,user}: next.forgejo.org: update with the new location
2023-12-25 20:35:53 +01:00
Popolon
a58c11744a
typo in systemctl
2023-12-24 22:42:12 +00:00
Earl Warren
c127ac6b59
developer: workflow: explain how to run end-to-end tests
...
Also fixes a few typos.
2023-12-21 17:02:15 +01:00
Earl Warren
10d2156c6e
developer: infrastructure: next.forgejo.org needs rm of the container
2023-12-18 21:36:00 +01:00
Paul Sargent
96f4c063f1
Arch Linux migration process ( #298 )
...
Add a description of the steps necessary to migrate a Gitea installation to Forgejo on Arch Linux using the native packages.
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/298
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Paul Sargent <psarge@gmail.com>
Co-committed-by: Paul Sargent <psarge@gmail.com>
2023-12-18 15:14:55 +00:00
Earl Warren
b311e9f8c4
admin: actions: s/forgejo-runners/myrunner/
2023-12-18 11:50:14 +00:00
Earl Warren
1afd0a4ef7
developer: infrastructure: quote commands
...
so that copy/pasting does not get non-ascii characters
2023-12-15 21:39:47 +00:00
Earl Warren
301f4b65f5
developer: release: renewal of the release key
2023-12-15 18:53:20 +01:00
teutat3s
1886c54138
admin: actions: br-+ should be a trusted interfaces
...
in the NixOS firewall for actions cache to work with docker runners
2023-12-14 10:39:05 +00:00
teutat3s
42470f7ab3
user: actions: zstd is a dependency for the runner
...
cache extract / restore step
Fixes: #307
2023-12-13 02:26:16 +01:00
Earl Warren
64bdcbbb48
developer: infrastructure: no trailing / in reverse proxy
2023-12-12 11:58:52 +01:00
Earl Warren
691d8890cf
developer: infrastructure: hetzner{02,03} root file system backups
...
No information in the root filesystem is really worth saving as it
can be recreated from this documentation or even from scratch manually
if needs be. But it is cheap to keep that backup and it is worth the
effort if it can save a few hours of work when an accident happen.
The more sophisticated way to do it would be to setup DRBD with the
root file system. But this is not straightforward and to ensure it
won't get the admin in trouble when an accident happen is tricky. It
is the one time when every bit of complication can quickly become a
blocker or an unecessary burden.
2023-12-11 23:59:04 +01:00
Earl Warren
c6f7b3f688
developer: infrastructure: code.forgejo.org rotating backups
2023-12-11 22:16:03 +00:00
Earl Warren
13b6b38939
developer: infrastructure: next.forgejo.org
...
next.forgejo.org has been lagging for a few weeks in upgrades. While
crystal and dachary are busy, I setup and documented an LXC container
on the machine to which we all have access. It can be switched back to
where it was by updating the DNS entry.
2023-12-11 22:57:43 +01:00
Earl Warren
8058edc2a0
developer: infrastructure: IP & port forwarding
2023-12-10 14:48:45 +01:00
Earl Warren
0ab4028535
user: actions: automatic tokens do not trigger workflows
2023-12-10 11:28:25 +00:00
Antonin Delpeuch
bc5268061f
Change link for Emacs' go mode
2023-12-09 22:46:22 +00:00
Antonin Delpeuch
143454ae94
Remove trailing lines
2023-12-09 22:46:22 +00:00
Antonin Delpeuch
eda0ec8443
Remove GoLand
2023-12-09 22:46:22 +00:00
Antonin Delpeuch
b8e37e4237
Add page to document how to set up a dev environment
2023-12-09 22:46:22 +00:00
Earl Warren
54a3207eb3
admin: search-engines: be precise about where to find CustomPath
2023-12-08 20:31:28 +01:00
Harald Kirsch
ade42a313d
adds warning to avoid superfluous https: prefix when using npm registry
2023-12-08 20:14:40 +01:00
Earl Warren
0ed1f6d471
admin: SEND_NOTIFICATION_EMAIL_ON_NEW_USER needs ENABLE_NOTIFY_MAIL
2023-12-06 21:34:30 +00:00
Earl Warren
79266be552
admin: email: proofread and add links
2023-12-06 17:50:13 +01:00
Earl Warren
d2daf216e5
developer: infrastructure: document forgejo-helm runner
...
It is special because it needs extended permissions to run k8s tests.
2023-12-06 16:31:54 +00:00
Otto Richter
397b83a88c
Correct default license list
...
Actually match the file names in option/license.
Also see https://codeberg.org/forgejo/forgejo/pulls/1888
2023-12-05 22:06:43 +00:00
Earl Warren
69a63cea19
developer: infrastructure at hetzner
...
* document the current setup at hetzner01 and maintenance procedures
* document the new hardware setup at hetzner{02,03} for hosting code.forgejo.org
2023-12-05 22:36:09 +01:00
Earl Warren
a1ead9463a
developer: release: fix typo
2023-12-04 18:01:04 +00:00
s3lph
ac62015231
{user,admin}: actions: IPv6-capable Forgejo Runner
...
Preview
* Admin https://forgejo.codeberg.page/@docs_pull_243/docs/v1.21/admin/actions/
* User https://forgejo.codeberg.page/@docs_pull_243/docs/v1.21/user/actions/#execution-of-the-workflows
---
Forgejo runner receives IPv6 support in https://code.forgejo.org/forgejo/runner/pulls/120 . I was requested in https://code.forgejo.org/forgejo/runner/issues/119#issuecomment-3289 to provide documentation for this feature.
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/243
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: s3lph <codeberg@s3lph.me>
Co-committed-by: s3lph <codeberg@s3lph.me>
2023-12-04 17:42:08 +00:00
Antonin Delpeuch
34791eb810
Document Docker build procedure
...
Closes #241 .
2023-12-04 10:53:54 +00:00
oliverpool
d1cfdbc9b1
Revert "developer: release: maintenance policy"
...
This reverts commit 506e3961d8
2023-11-30 16:21:34 +01:00
oliverpool
b5cdc78e0c
admin: release life cycle
2023-11-30 16:00:29 +01:00
oliverpool
eee441b0bb
fix number of versions per year
2023-11-29 17:48:05 +00:00
oliverpool
ac4ae83940
s/unstable/experimental
2023-11-29 17:48:05 +00:00
oliverpool
ba7ac6659b
developer: release: maintenance policy
2023-11-29 17:48:05 +00:00
Silejonu
a484c04428
fix typo
2023-11-28 10:00:25 +00:00
Earl Warren
5c8175b0d3
developer: release: publish weekly test releases
...
Refs: https://codeberg.org/forgejo/discussions/issues/51
2023-11-27 18:03:37 +00:00
Earl Warren
3591cabfbc
developer: release: tests moved from setup-forgejo to end-to-end
2023-11-27 15:58:28 +01:00
Earl Warren
536b6e10e0
admin: upgrade: update the latest patch release versions
2023-11-25 15:20:48 +01:00
Earl Warren
54fea18974
user: actions: variable values can be modified
2023-11-24 16:58:08 +01:00
Earl Warren
0cca0479ee
admin: actions: the default runner is 3.2.0 now
2023-11-24 16:21:39 +01:00
Earl Warren
be5b8993c9
{user,admin}: oauth2-provider: pre-registered OAuth applications
2023-11-19 18:21:41 +01:00
Earl Warren
05de9ce86a
user: pull-request: add section on reviews
2023-11-15 23:53:41 +01:00
Earl Warren
927d806dbc
user: pull-request: import from Codeberg
2023-11-15 22:58:54 +01:00
Earl Warren
9b2b4fc4f4
{admin,developer}/customization: add user interface customization ( #244 )
...
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/244
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2023-11-15 21:23:43 +00:00
Earl Warren
4bba2896a5
user: label: section about archiving labels
2023-11-15 22:17:04 +01:00
Earl Warren
4596970531
admin: config: USE_PROXY_PROTOCOL is not working
2023-11-13 22:40:13 +01:00
Earl Warren
ef0292cb1d
admin: installation: selinux troubleshooting hint
...
https://matrix.to/#/!zpNKWqkiEOyljSMQDK:matrix.org/$R6rXeGdgUoRiEG2XrligRgg3YW5a8H0zf7xwBgqrvec?via=exozy.me&via=matrix.org&via=aria-net.org
2023-11-13 19:08:00 +00:00
Earl Warren
64d49d6bb2
admin: actions: LXC configuration
2023-11-13 18:46:23 +00:00
Earl Warren
44079f17a4
user: actions: s/options/container.options/
2023-11-11 00:35:31 +00:00
Earl Warren
9c0d4b25e5
{admin,user}: actions: runner 3.1+ support lxc + self-hosted
...
The upcoming 3.1 release of the Forgeo runner will allow to specify
which template and release must be must be used for a LXC
container. It also defines the lxc:// scheme as distinct from the
host:// scheme.
The host:// scheme is documented to be used for running jobs directly
from the host, which was not possible with the Forgejo runner versions
prior to 3.1
2023-11-09 13:01:11 +01:00
Earl Warren
7cf8b2fc95
user: actions: clarify pull_request_target will checkout the base
2023-11-08 16:16:59 +01:00
Gusted
fcb6347c18
Refactor blocking users page
...
- Update images to the 'new' design and have better consistency with
sizes (using Firefox's screenshot node feature).
- Add section for blocking users as a user of where to find the list of
blocked users and how to unblock them.
2023-11-03 13:26:24 +00:00
Gusted
c8d40af3e2
Use handlebars syntax highlight for Go templates
...
- [Shiki](https://github.com/shikijs/shiki ) doesn't support highlighting
Go templates, so instead use handlebars template highlighting for this
code snippet.
2023-11-02 22:32:33 +01:00
Earl Warren
533f575dde
developer/repositories-dependencies: no need to add collaborators
...
adding collaborators with write access to the destination repository
is a way for the author of a pull request to gain elevated privileges
2023-11-01 20:45:42 +01:00
Earl Warren
8bd4dac2dc
user/actions: actions/end-to-end => forgejo/end-to-end
2023-10-29 19:00:25 +01:00
Earl Warren
129702bd6a
user/actions: examples moved to end-to-end
...
https://code.forgejo.org/forgejo/end-to-end
2023-10-29 15:28:34 +01:00
Earl Warren
8cb1dbf218
develop/repositories-dependencies: explain the cascading-pr setup
...
It provides two concrete examples to illustrate how they are
useful. It also explains how the permissions and tokens are created
and installed.
2023-10-26 18:07:41 +02:00
Earl Warren
4e479f5a94
developer/RELEASE: checklist of dependencies for release notes
2023-10-24 11:11:12 +00:00
Earl Warren
ee97d72ee4
admin: upgrade: docker --all is docker check --all
...
check is the default command but the flags are handled differently
since the urfave/v2 refactor
2023-10-24 11:10:52 +00:00
Earl Warren
88269f91ca
user/labels: rework the page entirely
2023-10-23 12:43:29 +02:00
Earl Warren
64ba97d470
clarify the installation instructions
...
- split the installation page into separate pages for Docker, binary install, and packages
- clarify the next step is the installation page via the web
- clarify the first user created has admin rights
- clarify how values in the config sheet are provided when using Docker installation
- explain database preparation can be skipped if using SQLite which is built-in
Fixes: https://codeberg.org/forgejo/docs/issues/117
2023-10-22 10:30:40 +00:00
Earl Warren
dc58097aec
developer/infrastructure: add Uberspace
...
Refs: https://codeberg.org/forgejo/governance/issues/36
2023-10-20 17:04:33 +02:00
Earl Warren
560c50495e
admin: installation: remote data folder rewording
2023-10-15 14:45:58 +02:00
dbischof90
cabb9fca11
admin: installation: remote data folder ( #193 )
...
Documentation proposal for remote data mounting, following up from https://codeberg.org/forgejo/forgejo/issues/1590
Co-authored-by: Daniel Bischof <daniel.bischof@protonmail.com>
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/193
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: dbischof90 <dbischof90@noreply.codeberg.org>
Co-committed-by: dbischof90 <dbischof90@noreply.codeberg.org>
2023-10-14 17:42:40 +00:00
Earl Warren
26ce6aa32b
admin: adopt
2023-10-09 14:43:08 +00:00
Earl Warren
0b81e66c45
sync with Gitea abe8fe352711601fbcd24bf4505f7e0b81a93c5d
...
git diff bd4c7ce578956d9839309b16753bd5505b63b2e3..abe8fe352711601fbcd24bf4505f7e0b81a93c5d -- $(find . -type f -name '*en-us*')
2023-10-08 15:21:44 +00:00
Earl Warren
89c24509f0
sync with Codeberg 7bb8fa5ca559073c028805888195ee31b1f3d9c2
...
https://codeberg.org/Codeberg/Documentation
git diff 77bfb6cc15d180d506881e9629e73d1064c11dda..7bb8fa5ca559073c028805888195ee31b1f3d9c2 > doc.patch
2023-10-08 16:28:54 +02:00
Earl Warren
c4a2a40f6f
user: actions: fix links to examples
...
* the postgresql.yml file was merged into test.yml
* add links to test.yml directly rather than the directory to save one click
2023-10-08 00:59:57 +02:00
Earl Warren
aaaff32bb3
user: actions: ony two level of nesting
2023-10-08 00:36:01 +02:00
Earl Warren
8bd50bb4ef
user: actions: explain errors tooltip
2023-10-07 18:02:48 +02:00
Earl Warren
142d8a03d1
admins: actions: one token can register multiple runners
...
See 9b698362a3
2023-10-07 17:17:26 +02:00
Loïc Dachary
a0b72f9d49
admin: upgrade
...
Downgrade is never supported, there is no need to include details in
the documentation about the database versions.
2023-10-06 06:32:14 +00:00
Earl Warren
6a7a7715d7
user: actions: fix typo
2023-10-05 12:59:02 +02:00
Earl Warren
f543af1e87
{admin,user}: actions: update log & artifact storage & usage
2023-09-30 00:46:03 +02:00
Earl Warren
d0c10d5716
user: actions: add on.pul_request* and on.schedule examples
2023-09-29 14:36:28 +02:00
Earl Warren
1f7a005627
user: actions: on.pull_request_target workflows are not moderated
2023-09-28 16:49:48 +00:00
Earl Warren
f5d5e6d7b4
user: actions: disable / enable a workflow from the UI
...
and also update the screenshots of the list of tasks and the details
of a task.
2023-09-28 16:49:29 +00:00
Earl Warren
9f8c592699
admin: actions: labels can be updated by the runner when it connects
2023-09-28 16:37:06 +00:00
Earl Warren
b4bf3c5a11
user: actions: add `on.pull_request{,_target}
...
Also remove the list of types because they are unhelpful and probably
misleading.
2023-09-28 16:04:56 +00:00
Earl Warren
b71f102e9c
admin: actions: enabled by default
2023-09-28 14:05:19 +00:00
Earl Warren
2cc8fba302
admin: actions: move misplaced nixos section
2023-09-28 15:53:54 +02:00
Earl Warren
f1737a5ecd
user: actions: add on.schedule
2023-09-24 23:15:59 +02:00
Earl Warren
df703accac
user: actions: variables
...
and also update the secrets list & addition screenshots as the layout
has changed
2023-09-23 15:55:59 +00:00
Earl Warren
a527b6fd23
user: config-cheat-sheet: updates from Gitea
2023-09-22 20:00:16 +02:00
Earl Warren
43a07a1cba
user: blame: adapt to Forgejo ( #146 )
...
Caution: it needs to be squashed before merge to be backported. It is kept as two commits to preserve the original version.
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/146
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2023-09-22 17:58:24 +00:00
Earl Warren
b77359bfb1
sync with the latest changes from Gitea
...
git log --patch faa28b5a44912f1c63afddab9396bae9e6fe061c..8d9e2d07f3f84a86265fdbe0ab7fcf63cc34ddbd . ':(glob)docs/**/*.en-us.md'
2023-09-22 19:20:11 +02:00
Earl Warren
9056bcfc37
admin: new section on user moderation
...
Also
s/NOTIFY_NEW_SIGN_UPS/SEND_NOTIFICATION_EMAIL_ON_NEW_USER/
See https://codeberg.org/forgejo/forgejo/pulls/1481
2023-09-22 17:04:58 +02:00
Caesar Schinas
5d167821dc
generate CLI docs from forgejo docs with a perl script
2023-09-22 14:37:01 +00:00
Octol1ttle
5f017fbf77
Add a note about keychain storage location quirks
...
Signed-off-by: Octol1ttle <l1ttleofficial@outlook.com>
2023-09-20 05:14:52 +00:00
crystal
18938804e6
Fix admin runner management URI
2023-09-19 22:24:31 -06:00
Earl Warren
5cb08022ad
admin: signing: adapt for Forgejo ( #130 )
...
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/130
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2023-09-18 12:48:55 +00:00
Earl Warren
8cdd6202c7
developer: add warning for make watch
...
See https://github.com/go-gitea/gitea/issues/27029
2023-09-14 06:50:20 +00:00
Gusted
4479191be8
user: add repository transfers to blocking users documentation
...
- Ref: https://codeberg.org/forgejo/forgejo/pulls/1436
2023-09-14 07:59:39 +02:00
Earl Warren
0a53b0a2cf
developer: the minimum node version is 20
...
Things will fail in mysterious ways with lower version. For instance when
trying `make watch` the page won't load and complain index.js is not found.
2023-09-12 18:01:51 +02:00
Earl Warren
ab5076eea3
user: api: explain how to obtain pagination defaults
2023-09-10 09:00:20 +00:00
Flightkick
62d6fc9754
docs: Add an example for registry credentials.
2023-09-10 08:53:05 +00:00
crystal
622ba909cc
fix "customization" typo
2023-09-09 15:07:29 -06:00
Richard Rahl
3e3ddf4bd0
fix docker-compose files to actually make the installation persistent
2023-09-05 21:12:28 +02:00
Aravinth Manivannan
e18635359b
feat: document admin.NOTIFY_NEW_SIGN_UPS in configuration cheat sheet
2023-09-04 16:08:39 +05:30
firefly-cpp
c090305970
developer:fix link (sustainability)
2023-09-03 22:05:50 +02:00
Caesar Schinas
ca28203c54
admin:database-preparation: use different password from username in examples
2023-09-02 23:20:28 +01:00
Earl Warren
314ca54b64
user: actions: document if ( #102 )
...
Also use YAML pseudo path as chapter headings because it makes it easier to find from the TOC
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/102
Reviewed-by: Caesar Schinas <caesar@caesarschinas.com>
Reviewed-by: Forgejo Release Team <release-team@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2023-09-02 19:34:24 +00:00
Caesar Schinas
c64d2ccd06
move images to content dir and use relative paths
...
This is necessary for the website upgrade to Astro v3, which has a new built-in image API.
2023-08-31 23:07:42 +01:00
Earl Warren
852b447f91
admin: storage: updates and improve S3
...
The original documentation was written with a focus on local storage
and missed a few important aspects of how storage types can be mixed
together in some subsystems.
* unify the susbsystem paths to be "directory" instead of using "base
path". It is not technically a directory in S3 but looks like one
and the approximation is unlikely to cause confusion.
* use S3 instead of minio where possible to emphasize the storage type
is not MinIO specific and add a section for the compatibility with
garage
* change the document structure to have two separate parts:
* [storage] the global sections
* [xxxx] the subsystem specific section
and within each of them local and S3 are documented separately
because they share nothing
* [storage] is documented to be a fallback if [xxxx] does not exist
for a given subsystem. There is no notion of inheritance because
it behaves in ways that are not tested and for which consistency is
not guaranteed
* backward compatibility with Gitea is documented to be the reason why
there are no safeguards against undocumented features
2023-08-31 12:35:32 +02:00
Gusted
693f849196
developer: add ARCHITECTURE file
...
- As per https://codeberg.org/forgejo/discussions/issues/53#issuecomment-1070207
2023-08-30 17:11:06 +00:00
Earl Warren
a8736608ba
admin: installation: address caesar comments
...
https://codeberg.org/forgejo/docs/pulls/92#issuecomment-1091839
2023-08-30 15:27:51 +02:00
firefly-cpp
12cf38145e
admin:installation:Installation from package docs
2023-08-30 13:08:15 +02:00
crystal
b0319eaa02
Add next.forgejo.org documentation
2023-08-29 19:49:52 -06:00
Earl Warren
ac639fae68
admin: actions: update the runner download name
...
The name scheme changed with version 3.0.0
2023-08-28 12:27:29 +02:00
Caesar Schinas
3573e7ceac
add link to command-line
2023-08-27 15:18:31 +00:00
Caesar Schinas
713824565b
grammar and formatting improvements in command-line
2023-08-27 15:18:31 +00:00
Caesar Schinas
6c5e27d8f9
s/gitea/forgejo/ in command-line docs
2023-08-27 15:18:31 +00:00
Caesar Schinas
b7c2392a4c
import command-line docs from Gitea
2023-08-27 15:18:31 +00:00
Earl Warren
ace3c8f8e9
address caesar comments
2023-08-27 06:06:03 +00:00
Earl Warren
86df6f07b2
typo
2023-08-27 06:06:03 +00:00
Earl Warren
705958fcfa
address gusted comments
2023-08-27 06:06:03 +00:00
