foster/forgejo-docs
0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-25 18:19:26 -05:00
Code Issues Activity
676 commits 7 branches 0 tags 19 MiB
Commit graph

131 commits

Author SHA1 Message Date
Earl Warren
e686086717 developer: dependency management guide 2024-04-03 09:53:18 +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
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
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
rom4nik
206ed546b9 developer/infrastructure.md: ephemral -> ephemeral 2024-03-16 02:44:22 +00:00
0ko
fe8a889cf4 developer: add Base localization guide 2024-03-11 18:00:00 +05: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
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
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
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
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
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
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
Panagiotis "Ivory" Vasilopoulos
6c755e61f4 developer/customization: use example.com example domain 2024-02-18 15:28:10 +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
0ko
ba0900a4e0 developer: update localization guide about edit access 2024-02-08 00:11:39 +05: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
0eoc
eebf84ef7d
developer: add localization contribution guide 2024-01-23 18:13:40 +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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
dc58097aec
developer/infrastructure: add Uberspace 
Refs: https://codeberg.org/forgejo/governance/issues/36
 2023-10-20 17:04:33 +02: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
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
8cdd6202c7 developer: add warning for make watch 
See https://github.com/go-gitea/gitea/issues/27029
 2023-09-14 06:50:20 +00: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
firefly-cpp
c090305970 developer:fix link (sustainability) 2023-09-03 22:05:50 +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
crystal
b0319eaa02
Add next.forgejo.org documentation 2023-08-29 19:49:52 -06:00
Caesar Schinas
581d02f1d7
s/Gitea/Forgejo/ 2023-08-27 00:02:54 +01:00
Loïc Dachary
f0c9ffab9e developer: release: document the steps 2023-08-22 22:12:41 +00:00
Loïc Dachary
67fdb5449b
developer: link to the CI file for go-version recommendation 2023-08-17 19:01:23 +02:00
Caesar Schinas
27864fec2b
move docs to subfolder 2023-08-15 00:19:15 +01:00