0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-25 18:19:26 -05:00
Commit graph

403 commits

Author SHA1 Message Date
0ko
9383360c7c Developer: improve Weblate announcement information 2024-06-18 09:52:54 +05:00
Ikuyo Kita
982e8fd215 user: issue-tracking-basics: update screenshot (#716)
Updates the screenshot in the issue tracking basics page, as it looks very dated (even shows the old Codeberg logo)

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/716
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Ikuyo Kita <kitakita@disroot.org>
Co-committed-by: Ikuyo Kita <kitakita@disroot.org>
2024-06-16 13:46:01 +00:00
Earl Warren
2d76e3a32c
admin: CLI: add F3 sub-command 2024-06-16 10:22:49 +02:00
0ko
edd4728e04 developer: corrections for base localization management 2024-06-14 20:07:53 +05:00
kita
7c3b81ec99
user: first-repository: update screenshots and content 2024-06-14 16:13:27 +08:00
9pfs
b362696091 Fix typo (bookwork -> bookworm) 2024-06-14 03:52:46 +00:00
Earl Warren
3a88278ae8 developer: infrastructure: EX101 with a ASRockRack only 2024-06-13 19:59:49 +00:00
Earl Warren
11859284af user: oauth2: illustrated example to add an authentication source (#703)
Preview: https://forgejo.codeberg.page/@docs_pull_703/docs/next/user/oauth2-provider/#using-a-codeberg-as-an-authentication-source
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/703
Reviewed-by: twenty-panda <twenty-panda@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2024-06-13 15:33:51 +00:00
Earl Warren
d718114a48 developer: infrastructure: read-only backpups of gna.org
For discussions related to Forgejo hosting services.

Refs: https://codeberg.org/forgejo/discussions/issues/72
2024-06-11 19:04:09 +00:00
Earl Warren
16834531f1
admin: storage: add missing MINIO_CHECKSUM_ALGORITHM setting
Fixes: https://codeberg.org/forgejo/forgejo/issues/4103
2024-06-11 17:37:05 +02:00
Earl Warren
2cebfa7231 developer: infrastructure: DRBD disaster recovery instructions
One step is missing when restarting the machine, which happened today
because of a network card failure.
2024-06-09 10:56:20 +00:00
Earl Warren
444cba3f20 developer: dependencies: do not require a label for each dependency
it is extra work and does not provide anything searching for past pull
requests with the same title would not.
2024-06-09 07:10:11 +00:00
0ko
faa6814244 Fix lint & a little English improvement 2024-06-08 12:36:57 +00:00
mirko
bc38574257 Add APP_SLOGAN config 2024-06-08 14:06:12 +02:00
Earl Warren
da4e314547 developer: dependencies: how to tune software upgrades 2024-06-08 07:56:47 +00:00
Léana 江
0222f4a502 add example config for neovim 2024-06-08 07:45:45 +00:00
Earl Warren
6fa1c28677 user: actions: document the default for shell
`jobs.<job_id>.steps[*].shell` defaults to `bash` unless
`jobs.<job_id>.container.image` is specified in which case it defaults
to `sh`.

Refs: https://code.forgejo.org/forgejo/runner/issues/150
2024-06-08 04:58:24 +00:00
Earl Warren
e400655e1c
developer: infrastructure: DRBD speedup trick
used while re-imaging hetzner01 to be the secondary of hetzner04
2024-06-03 14:31:13 +02:00
adagio
cd1507419f Fixes and updates installation-docker.md (#645)
Makes a minor correction to which is the next version number.

Also includes information about the `7.0` docker tag's versioning based on facts the author only can recall seeing on Matrix but currently cannot actually find direct proof of such messages existence for reference now.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/645
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-06-03 07:19:31 +00:00
adagio
c86099d84e
Updates whitelist to allowlist 2024-06-01 21:26:59 -04:00
adagio
a0a49c54b9 Updates installation steps (#632)
Applies standard running list sentence formatting.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/632
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-06-01 14:09:43 +00:00
Abdur-Rahman Mansoor
f2e3723bd3
style: fix more typos in /docs/admin 2024-05-31 16:47:58 -04:00
adagio
f8288ff9ff Updates installation.md (#631)
Adds a link to the releases management section in  `installation.md`.

Preview https://forgejo.codeberg.page/@docs_pull_631/docs/next/admin/installation/

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/631
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-05-31 13:41:56 +00:00
adagio
8ba517004d Fixes broken links (#675)
Preview: https://forgejo.codeberg.page/@docs_pull_675/docs/next/user/first-repository/

Redirect links as reported:

https://codeberg.org/forgejo/docs/issues/674
https://codeberg.org/forgejo/docs/issues/673
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/675
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-05-31 11:50:41 +00:00
Earl Warren
f9c4ad9e0b
developer: infrastructure: hosting {lab,cloud}.forgefriends.org 2024-05-31 10:18:42 +02:00
Earl Warren
1a8ed80ebd developer: infrastructure: hosting forum.forgefriends.org 2024-05-30 09:53:26 +00:00
Earl Warren
f2ad71255d
developer: secrets: link to gopass deb packages
I could not figure out where they are located from the install
instructions of gopass. It is implied but not explicit.
2024-05-30 09:34:52 +02:00
adagio
d141e54597 Modifies and reformats actions.md glossary (#630)
Adds contents to the glossary section of the `actions.md` file.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/630
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-05-30 05:54:01 +00:00
Abdur-Rahman Mansoor
c37e8619d6
style: fix lots of typos in installation-binary.md 2024-05-29 20:32:54 -04:00
Earl Warren
e7a037e4fe
developer: static-pages: setup forgefriends.org
Refs: https://codeberg.org/forgejo/discussions/issues/114
2024-05-29 15:43:34 +02:00
Earl Warren
5df2f0d0d3
developer: infrastructure: deploy a runner for forgefriends
Refs: https://codeberg.org/forgejo/discussions/issues/114
2024-05-29 08:59:34 +02:00
Earl Warren
6b6f79e6ff user: actions: indent issue 2024-05-28 20:58:30 +00:00
Earl Warren
ee6d19ca3f developer: infrastructure: document hetzner04 and rework everything
The page grew over the past year to have redundancies and
inconsistencies. It is organized to keep sections that are common to
all machines in one place:

* LXC container creation
* Forgejo runner creation
* DRBD
* vSwitch

The other sections are unified (Disk partitioning).
2024-05-28 20:58:14 +00:00
adagio
9326746c38 Adds consistency to sentence formatting in seek-assistance.md (#633)
Places `.` symbol at the end of a couple of list sentences.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/633
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-05-28 10:47:19 +00:00
Abdur-Rahman Mansoor
d35b4548d1 style: fix typos in /docs/admin (#656)
Now that I've finished `/docs/user`  I suppose I will start working on `/docs/admin`. I didn't change all the files at once since I thought it would be annoying for the maintainers to review. If you prefer I make all the changes at once, feel free to let me know and I would be happy to do that as well. :)

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/656
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-by: Caesar Schinas <caesar@caesarschinas.com>
Co-authored-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
Co-committed-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
2024-05-27 23:52:48 +00:00
Schiriki
c46f6bc4af
Replace gitea through forgejo 2024-05-28 00:21:02 +02:00
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
Abdur-Rahman Mansoor
ed5886012a style: fix more typos in /docs/user 2024-05-26 10:47:47 +00:00
Earl Warren
518407ccfe
admin: command-line: update
scripts/cli-docs.sh run next > docs/admin/command-line.md
2024-05-26 11:35:45 +02:00
Abdur-Rahman Mansoor
5c52eddd34 style: fix typos and use american spelling convention in some areas (#647)
You'll notice that asides from some typo fixes, "organisation" has been changed to "organization" to ensure a more consistent style guide, adapted to Codeberg's style: https://docs.codeberg.org/improving-documentation/style-guide/

Also changed "orgs" to "organizations" as it's more professional and easier to understand.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/647
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
Co-committed-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
2024-05-25 14:28:28 +00:00
Earl Warren
dc67b3c83a admin: installation: rootless data is in /var/lib/gitea by default
Refs: https://codeberg.org/forgejo/forgejo/issues/3869
2024-05-25 12:34:14 +00:00
Matthias Ahouansou
5c634782b9
Add guide to set branch to push to AGit pull request by default 2024-05-25 10:37:46 +01:00
adbagio
cd43c8b018 Docker installation detail fixes (#643)
Updates and fixes version descriptions for the latest Forgejo Docker image.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/643
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adbagio <h759bkyo4@mozmail.com>
Co-committed-by: adbagio <h759bkyo4@mozmail.com>
2024-05-24 07:50:39 +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
Shiny Nematoda
970f8a24f0 update code search (forgejo/forgejo#3654) 2024-05-17 10:44:54 +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
0ko
a83db24507 Replace Knut source link with IA 2024-05-16 19:30:20 +05:00
adbagio
f5b51da942 adds and updates hierarchy section 2024-05-16 07:40:42 +00:00
Earl Warren
2821d3cec4
admin: command-line: add actions-artifacts option
scripts/cli-docs.sh run next > docs/admin/command-line.md

Refs: https://codeberg.org/forgejo/forgejo/pulls/3772
2024-05-15 20:08:51 +02: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
Crown0815
720667cf04 Fix incorrect default value in CheatSheet for attachment MaxSize
I tested my forgejo instance and it says that it cannot upload files larger than 2048 MB.
I also confirmed on the gitea cheatsheet where the value is also 2048 MB
(see https://docs.gitea.com/administration/config-cheat-sheet#issue-and-pull-request-attachments-attachment)
2024-05-14 10:00:38 +00:00
jwildeboer
784e395e97 Update Issue/PR Template doc (#609)
Preview: https://forgejo.codeberg.page/@docs_pull_609/docs/next/user/issue-pull-request-templates/#directory-names

Proposal based on https://codeberg.org/forgejo/docs/issues/607 to make the docs more readable and add the `.forgejo` directory. Also added the `ref` and `labels` options to the yaml example.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/609
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: jwildeboer <jwildeboer@noreply.codeberg.org>
Co-committed-by: jwildeboer <jwildeboer@noreply.codeberg.org>
2024-05-12 18:43:11 +00:00
Kwonunn
c1b7969c1d Reverse Proxy setup guide (#600)
I've added a more comprehensive guide to set up Reverse Proxies.

So far I've added nginx configuration, I'm also planning to add apache configuration later on.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/600
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Kwonunn <kwonunnx@gmail.com>
Co-committed-by: Kwonunn <kwonunnx@gmail.com>
2024-05-10 07:22:19 +00:00
Earl Warren
359caf8476 admin(actions): the latest stable runner is 3.4.1 2024-05-10 07:19:38 +00:00
cascading-pr
131300c912 cascading-pr update 2024-05-10 05:39:23 +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
4cba3d36b3 Fix dead links 2024-05-05 06:18:43 +00:00
OniriCorpe
cd06bf37c5 Fix the 'Forgejo numbering scheme' link 2024-05-02 23:52:48 +00:00
alydev
0bfc31bd0a
SSL note for minio storage, fixed dead link 2024-05-01 18:33:10 +10:00
Earl Warren
2a12684354
admin(cli): update 2024-04-30 17:37:19 +02:00
Earl Warren
d9c4a8bd18 admin: upgrade: drop issue.created when upgrading from gogs
Refs: https://codeberg.org/forgejo/forgejo/issues/3488
2024-04-28 20:37:17 +00:00
Earl Warren
bea94cd9bd Revert "Add rootless installation instructions"
This reverts commit 345765e21f.
2024-04-28 20:36:03 +00:00
Firepup650
a1106f2fce Fix a broken link
`[clean up job]../../admin/config-cheat-sheet/#cron---cleanup-expired-packages-croncleanup_packages)` -> `[clean up job](../../admin/config-cheat-sheet/#cron---cleanup-expired-packages-croncleanup_packages)`
2024-04-28 14:55:54 +00:00
Robin Kloppe
d9db0d13f6 Added Repo Mirros (#568)
In a next step https://codeberg.org/forgejo/forgejo/pulls/3503 can be merged

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/568
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Robin Kloppe <git@mainboarder.de>
Co-committed-by: Robin Kloppe <git@mainboarder.de>
2024-04-28 08:58:32 +00:00
Otto Richter
c6c39005b0 Document database.MAX_OPEN_CONNS limit
See https://codeberg.org/forgejo/forgejo/pulls/3500
and https://codeberg.org/forgejo/forgejo/pulls/3383
for details.
2024-04-27 22:39:00 +02:00
cascading-pr
ef11b41eb5 cascading-pr update 2024-04-25 13:40:26 +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
cd3c76c05d docs: user: new section on comment on issues & PR via email 2024-04-23 09:03:49 +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
2a91eef705 prerelease version docs 2024-04-21 06:47:51 +00:00
Otto Richter
7c8c649cc9 Sync list of default themes
See https://codeberg.org/forgejo/forgejo/pulls/1746
2024-04-21 06:47:08 +00:00
crystal
d58d729c58
fix 404 2024-04-20 16:59:47 -06:00
Earl Warren
4ce64e2840 docs: pick the Forgejo release from experimental (#542)
in the case of a release that is not yet published, it will exist as
release candidates in the experimental organization. Every release go
through there and it is a reliable source.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/542
Reviewed-by: crystal <crystal@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2024-04-20 08:39:14 +00: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
crystal
34ab587e0f
replace gna.org links with archive.org mirrors
gna.org is apparently gone
2024-04-18 21:38:30 -06: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
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, because
the functionality has been superseded by a different implementation.

Signed-off-by: Gergely Nagy <forgejo@gergo.csillger.hu>
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