0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-22 17:48:39 -05:00
Commit graph

102 commits

Author SHA1 Message Date
Earl Warren
77e3e1205f developer: infrastructure: static pages hosting
Run a LXC container that hosts static pages.

* manual one time configuration (web server configuration, git clone
  of content)
* webhook based pull for updates

It is created to host the F3 documentation. It can be used in the
future to host the Forgejo website and retire Uberspace.

Refs: https://codeberg.org/forgejo/governance/issues/36
Refs: https://forgejo.org/docs/v7.0/developer/infrastructure/#uberspace
Refs: https://codeberg.org/forgejo/discussions/issues/114
2024-05-26 21:36:04 +00:00
adbagio
27118e60fe Updates localization.md (#642)
Continues progress made in: https://codeberg.org/forgejo/docs/pulls/469

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/642
Reviewed-by: 0ko <0ko@noreply.codeberg.org>
Co-authored-by: adbagio <h759bkyo4@mozmail.com>
Co-committed-by: adbagio <h759bkyo4@mozmail.com>
2024-05-24 06:02:10 +00:00
Earl Warren
8a28a4db15 developer: dependency: release notes example 2024-05-16 21:14:53 +00:00
Earl Warren
a09cea8876 developer: compiling requires go v1.22 not v1.21 2024-05-16 21:05:37 +00:00
TheFox0x7
b6b99c0b55 Add Caddy config to reverse proxy section (#605)
Added Caddy example configs, turned on syntax highlighting in nginx/apache

Closes: forgejo/website#232
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/605
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: TheFox0x7 <thefox0x7@gmail.com>
Co-committed-by: TheFox0x7 <thefox0x7@gmail.com>
2024-05-14 23:07:03 +00:00
0ko
fb73fd507d Localization: add instructions for fixing various failures with Weblate CL 2024-05-14 22:32:31 +00:00
Earl Warren
359caf8476 admin(actions): the latest stable runner is 3.4.1 2024-05-10 07:19:38 +00:00
Earl Warren
38c90ce5d6 developer(infrastructure): ubuntu-runner.forgejo.org 2024-05-07 10:54:55 +00:00
Earl Warren
5acda1e0b2 developer: release: cut the documentation branch
- add a checklist to the release instructions
- use a pattern for push instead of an explicit list of branches
  it was previously advisable to avoid conflicts when there was
  no automated backports but it is no longer necessary
2024-05-07 10:53:58 +00:00
Yaroslav Halchenko
9ad5f2ab0f Add codespell support (without CI) and make it fix some typos (#536)
Per "request" of @0ko in https://codeberg.org/forgejo/forgejo/pulls/3270#issuecomment-1774032

TODOs
- postponed: how to add codespell (written in Python) to CI -- separate workflow? add to some other step? to some other tool/specification?

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/536
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Yaroslav Halchenko <debian@onerussian.com>
Co-committed-by: Yaroslav Halchenko <debian@onerussian.com>
2024-05-05 14:53:04 +00:00
0ko
bcd7348a70 localization admin: add Weblate announcement 2024-04-24 18:58:31 +05:00
Earl Warren
a0477a8300 LTS: is not part of the metadata & CLI updates (#561)
- LTS are listed in the table, no hint in the version number
- update the RC release names
- CLI updates

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/561
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2024-04-23 15:57:31 +00:00
Earl Warren
6aa9b491a0 sync with Gitea e865de1e9d65dc09797d165a51c8e705d2a86030
cd docs
git diff d3982bcd814bac93e3cbce1c7eb749b17e413fbd..e865de1e9d65dc09797d165a51c8e705d2a86030 -- $(find . -type f -name '*en-us*')
2024-04-23 07:16:10 +00:00
Earl Warren
06233a63cd developer: release: octopuce is not publicly visible 2024-04-21 07:03:44 +00:00
Earl Warren
51a1f2951e developer: infrastructure: v7.next.forgejo.org 2024-04-21 06:52:09 +00:00
0ko
82ab0bb31b developer: update localization admin guides 2024-04-21 06:49:58 +00:00
crystal
d58d729c58
fix 404 2024-04-20 16:59:47 -06:00
crystal
bd8e4e588a timetzdata is in the release build tags 2024-04-20 07:26:55 +00:00
Earl Warren
396b73db5d developer: 7.0 pushed to 23 April 2024
Refs: https://matrix.to/#/!zpNKWqkiEOyljSMQDK:matrix.org/$NbJVQF3bOEMbfFbfq-IhydQPukQuHvsz3Vi6A2ozWCU?via=schinas.net&via=matrix.org&via=envs.net
2024-04-19 15:06:40 +00:00
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
0ko
b4354d111a Developer: Base localization: add Contributing section 2024-04-11 14:43:22 +00:00
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