Commit graph

432 commits

Author SHA1 Message Date
Sepperlot
29c674e528 fix: SSH repo URLs (#716)
Correct SSH URL examples to avoid confusion. Codeberg supports two different SSH URL formats with different delimiters (`:` vs `/`), but the current documentation mixes them, which can lead to misconfigurations - especially when using pattern-based Git configurations such as `includeIf "hasconfig:remote.*.url:`

There are two valid SSH URL formats when accessing Codeberg repositories:

1. SCP-like syntax (colon delimiter)
```bash
git@codeberg.org:<user>/<repo>.git
```

2. Full SSH URL syntax (slash delimiter)
```bash
ssh://git@codeberg.org/<user>/<repo>.git
```

Git treats these formats differently, so inconsistent examples in documentation can cause tools or config conditions to fail. In my case, `includeIf "hasconfig:remote.*.url:"` did not match correctly because the documented format did not reflect the proper SSH URL structure.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/716
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Sepperlot <sepperlot@noreply.codeberg.org>
Co-committed-by: Sepperlot <sepperlot@noreply.codeberg.org>
2025-12-09 15:15:02 +01:00
TalpaEuropaea
eec6e02abf doc: fixed typo in content/git/reduce-size.md (#717)
Added a missing "to".

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/717
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: TalpaEuropaea <talpaeuropaea@noreply.codeberg.org>
Co-committed-by: TalpaEuropaea <talpaeuropaea@noreply.codeberg.org>
2025-12-08 16:23:43 +01:00
Panagiotis "Ivory" Vasilopoulos
c9f21ef387 Contact: Add deadline disclosure for press/media inquiries (#715)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/715
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-committed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2025-12-06 18:17:38 +01:00
Panagiotis "Ivory" Vasilopoulos
91a4e26fe2 Contact: Add press contact email (#714)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/714
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-committed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2025-12-06 14:22:06 +01:00
Clara Engler
51abafc725 Note about CC0 for code (#704)
The Creative Commons organization explicitly marks in their FAQ that
`CC0` is fine for software.  Besides, many software projects are
released under it and it is considered `GPL` compatible.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/704
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Clara Engler <cve@cve.cx>
Co-committed-by: Clara Engler <cve@cve.cx>
2025-11-24 15:32:51 +01:00
mystie
ac93059053 fix typo in content/markdown/faq.md (#703)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/703
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: mystie <mystie@noreply.codeberg.org>
Co-committed-by: mystie <mystie@noreply.codeberg.org>
2025-11-22 11:07:10 +01:00
Javier Pérez
941914f698 Fix lint issues (#629)
# Changelog

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## Fixed

- Lint issues:
  - Line length ([MD013](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md013.md)).
  -  Heading levels should only increment by one level at a time ([MD001](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md001.md)).
  - Link fragments should be valid ([MD051](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md051.md)).
---

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/629
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Javier Pérez <walpo@noreply.codeberg.org>
Co-committed-by: Javier Pérez <walpo@noreply.codeberg.org>
2025-11-21 12:35:05 +01:00
wetneb
9a3e75194b Mention the feature to invite by email (#690)
There is a very hidden feature in the management of team members: it is possible to invite people by email!
I intend to work more on this area to improve this feature, but in the meantime here's an update to the docs so that it's a bit more discoverable.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/690
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: wetneb <wetneb@noreply.codeberg.org>
Co-committed-by: wetneb <wetneb@noreply.codeberg.org>
2025-10-30 18:09:03 +01:00
crystal
9e4e00d7d0 improve custom domain examples (#557)
- remove codeberg.page from .domains, it's redundant, the pages-server
  does not validate the .domains file for codeberg.page domains
- add information for www-apex redirects to apex examples

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/557
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: crystal <crystal@noreply.codeberg.org>
Co-committed-by: crystal <crystal@noreply.codeberg.org>
2025-10-30 17:05:41 +01:00
Panagiotis "Ivory" Vasilopoulos
cd08e66317 Contact: Add 'Community channels' section to Abuse (#685)
- Mention where reports should be made.
- Mention expectations regarding propagation of bans and provide context.
- Provide additional means of recourse in cases of interpersonal conflicts
  between a participant and a moderator.
- Explain that moderation standards can be stricter (and not ToU-only)
  at the behest of a moderator.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/685
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-committed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2025-10-26 13:30:40 +01:00
Arno Welzel
1047a82256 Update documentation (README, Forgejo Actions) (#667)
- Updated README.md to explain how to do linting and use prettier.
- Updated "Using Forgejo Actions (Self-hosted)" by pointing to the the official Forgejo documentation to avoid duplicating content.

Co-authored-by: Gusted <gusted@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/667
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Arno Welzel <privat@arnowelzel.de>
Co-committed-by: Arno Welzel <privat@arnowelzel.de>
2025-10-20 19:04:43 +02:00
Gusted
32485acc13 chore(deps): update dependency prettier to v3.6.2 (#686)
Co-authored-by: woodpecker-bot <woodpecker-bot@obermui.de>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/686
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2025-10-20 18:58:07 +02:00
Otto Richter
2f42adda8b Various updates to the FAQ (#662)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/662
Reviewed-by: Moritz Marquardt <momar@noreply.codeberg.org>
Co-authored-by: Otto Richter <otto@codeberg.org>
Co-committed-by: Otto Richter <otto@codeberg.org>
2025-10-13 14:26:23 +02:00
Gusted
1845a1984c fix: remove hugo link (#680)
It has been removed from hugo.

Ref: ce5a249f24

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/680
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2025-10-13 02:36:14 +02:00
Panagiotis "Ivory" Vasilopoulos
04b2fa9fc8 Contact: Update and elaborate Abuse section (#678)
- Mention Report content button
- Summarize expectations
- Mention on-site/off-site behavior

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/678
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Beowulf <beowulf@beocode.eu>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2025-10-10 18:52:25 +02:00
dawe
23b6a2e990 fix: improve and fix some wording in the CI section (#675)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/675
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: dawe <dawedawe@posteo.de>
Co-committed-by: dawe <dawedawe@posteo.de>
2025-09-19 13:19:37 +02:00
kevinhikaruevans
a4e80b85a7 fix: do not suggest both an A and CNAME record (#671)
I think this was a copy-paste error. But you cannot have both A and CNAME records on the same name. Only A/AAAA/TXT are the records needed here.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/671
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: kevinhikaruevans <kevinhikaruevans@noreply.codeberg.org>
Co-committed-by: kevinhikaruevans <kevinhikaruevans@noreply.codeberg.org>
2025-09-14 13:28:09 +02:00
Kilian Koeltzsch
83ac61e9a8 add warning about pages for repositories with a dot in the name (#670)
Hi,

coming from https://codeberg.org/Codeberg/pages-server/issues/512, this adds a warning that repos with dots in the name can cause issues when trying to set up a custom domain.

I'm not sure if the wording here fits the existing docs, or if hints like this fit in the docs at all, but I wanted to open this as a suggestion nonetheless :)

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/670
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: Kilian Koeltzsch <me@kilian.io>
Co-committed-by: Kilian Koeltzsch <me@kilian.io>
2025-09-12 15:32:49 +02:00
hugobuddel
cff67c76cb Use full path when specifying ssh key file (#669)
Using a `~` apparently does not work with `ssh-keygen`:
```
$ ssh-keygen -t ed25519 -a 100
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/knud/.ssh/id_ed25519): ~/.ssh/id_ed25519_codeberg
Enter passphrase for "~/.ssh/id_ed25519_codeberg" (empty for no passphrase):
Enter same passphrase again:
Saving key "~/.ssh/id_ed25519_codeberg" failed: No such file or directory
```

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/669
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: hugobuddel <hugo@buddelmeijer.nl>
Co-committed-by: hugobuddel <hugo@buddelmeijer.nl>
2025-09-06 14:00:07 +02:00
mst
224d96e4a7 Fix bottom margin in admonitions and card text + fix card margin on 'Donating to Codeberg' page (#668)
**Before:**

![Screenshot 2025-08-22 at 23-58-56 Your First Repository Codeberg Documentation](/attachments/ef01b002-5c3a-4132-8a36-e84f5a09b110)
![Screenshot 2025-08-23 at 00-07-41 Your First Repository Codeberg Documentation](/attachments/b16328c6-3f3e-45df-93b7-9ef5e6eafff5)
![Screenshot 2025-08-23 at 00-16-37 Donating to Codeberg Codeberg Documentation](/attachments/db873806-9de6-4324-9eef-d6f95ea13f0f)

**After:**

![Screenshot 2025-08-23 at 00-07-01 Your First Repository Codeberg Documentation](/attachments/a7fce9ee-ced5-45b6-9e93-c4ce3234b07b)
![Screenshot 2025-08-23 at 00-08-13 Your First Repository Codeberg Documentation](/attachments/c04acf6c-a293-4824-a90e-2650ed05d810)
![Screenshot 2025-08-23 at 00-17-21 Donating to Codeberg Codeberg Documentation](/attachments/e5caf5ee-00c0-4a18-8ed8-a6790989b0f0)

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/668
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: mst <oivan2401@gmail.com>
Co-committed-by: mst <oivan2401@gmail.com>
2025-08-23 01:52:48 +02:00
Otto Richter
9533f44b89 Update private repo FAQ (#660)
Matches some uncertainty and questions from Mastodon. The previous quote box drew a lot of attention, while it was not actually the point we wanted to convey.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/660
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Reviewed-by: Beowulf <beowulf@beocode.eu>
Co-authored-by: Otto Richter <otto@codeberg.org>
Co-committed-by: Otto Richter <otto@codeberg.org>
2025-08-12 19:59:24 +02:00
Gusted
f564ca6cd2 Use Halfmoon v2 (#655)
Refresh Codeberg documentatation looks by using Halfmoon v2.

Mobile UI also got a overhaul.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/655
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Otto <otto@codeberg.org>
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2025-08-12 17:53:32 +02:00
Gusted
de0217c6bc Fix image in getting started wiki page (#657)
The alt text contained quotes which messed with the parsing of the image element.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/657
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: Gusted <gusted@noreply.codeberg.org>
Co-committed-by: Gusted <gusted@noreply.codeberg.org>
2025-08-12 13:26:52 +02:00
Bastian Greshake Tzovaras
e004b03c97 Codeberg Pages: add custom 404 instructions (#654)
Closes #653

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/654
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
Co-committed-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
2025-08-08 04:38:35 +02:00
Jan Koll
b97624349b fix: correct typo in inline-css (#647)
Fixes #646

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/647
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Jan Koll <jan.niklas.koll@gmail.com>
Co-committed-by: Jan Koll <jan.niklas.koll@gmail.com>
2025-07-21 13:09:13 +02:00
freyalin
aaede8c9bb main (#644)
Greetings,

I have been using Hugo and hosted Forgejo Actions to publish the static site to Codeberg Pages, and I noticed that there's no instructions on automatic deploy with custom domain. It's worth noticing that `.domains` file should be placed at the `static` directory for Hugo, and accordingly for other SSGs, instead of  root of source repository, in order to preserve it to the output branch.  I will also initiate a PR to Hugo documents regarding the sample Forgejo Action `hugo.yaml` setup.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/644
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: freyalin <xlin@mailbox.org>
Co-committed-by: freyalin <xlin@mailbox.org>
2025-07-18 16:39:24 +02:00
Panagiotis "Ivory" Vasilopoulos
78e5235f20 FAQ: Replace relatively very easy with very easy (#642)
See: https://codeberg.org/Codeberg/Documentation/pulls/641#issuecomment-5837717

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/642
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
2025-07-15 23:11:18 +02:00
Panagiotis "Ivory" Vasilopoulos
baea8c83e9 Improve title of license requirement (#641)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/641
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2025-07-15 22:56:17 +02:00
Panagiotis "Ivory" Vasilopoulos
a26bb35eb6 Outline motivations for license requirement (#640)
- Add public domain dedication mention
- Add instructions for people unsure about licenses
- Add focus for private content

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/640
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2025-07-14 22:13:11 +02:00
Bastian Greshake Tzovaras
43af756a75 Add docs on how to reduce git repo size/remove files (#639)
Given the plan to enable the storage quotas at some point in the future, instructions for how to reduce the size of git repos will become more relevant (and indeed, this has been a recurring question that came up on Codeberg, Matrix etc since announcing the quotas).

Building on @aral's draft in #418 I've gone ahead and took a stab at adding such a docs page, which hopefully helps outline the approach with enough warnings 😆

Closes #418

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/639
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
Co-committed-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
2025-07-12 16:10:52 +02:00
Bastian Greshake Tzovaras
7cfd905bd4 add docs on alternative link syntax (#638)
This adds a small section to the markdown link section of the docs to also outline the `[[ link ]]` syntax that is supported in markdown texts that are rendered to html.

Closes #524.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/638
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
Co-committed-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
2025-07-11 21:09:46 +02:00
Bastian Greshake Tzovaras
d17122d241 Add Details on Woodpecker targets & comparison WP/Actions (#635)
This is targeted to close both #545 and #595 by

* explicitly mentioning the Woodpecker target
* link to the actions meta repo that provides some overview on Actions & Woodpecker

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/635
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
Co-committed-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
2025-07-02 16:27:43 +02:00
Pigeon-AFA
9b85081adf Security section: small additions (#634)
- Added Ente Auth to list of 2FA apps due to its open source/E2EE/cross platform nature
- Added links to the relevant user settings for SSH keys

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/634
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Pigeon-AFA <antifantwerp@proton.me>
Co-committed-by: Pigeon-AFA <antifantwerp@proton.me>
2025-07-01 20:59:00 +02:00
aec
71a83596f9 Add Wayland method to copy SSH key (#631)
Adds a method for using `wl-clipboard` to copy the SSH key on Wayland compositors.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/631
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: aec <aec@noreply.codeberg.org>
Co-committed-by: aec <aec@noreply.codeberg.org>
2025-06-26 00:59:27 +02:00
Bastian Greshake Tzovaras
94a88006df Link examples on how to use a CI for publishing SSG pages (#628)
In #601, the suggestion was made to provide details on how to use a CI to get a website published to Codeberg Pages when using a static site generator.

We already provide a lot of details on that via the Woodpecker CI examples repo, so I've linked to that to help people find those details!

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/628
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
Co-committed-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
2025-06-18 23:03:30 +02:00
Christopher A. Grant
73f5bfef39 Added documentation for CI agents (#554)
For some reason neither the docker image nor pnpm serve work on my machine.
TODO:
- [ ] test examples
- [ ] finish polishing
- [ ] add the rest of the references
- [ ] add helm details
- [ ] add autoscaler details

Co-authored-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: pat-s <pat-s@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/554
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: Christopher A. Grant <chris@aptenodytes.ca>
Co-committed-by: Christopher A. Grant <chris@aptenodytes.ca>
2025-06-17 01:12:39 +02:00
Javier Pérez
875cb34bdc Refactor and fix tables (#627)
# Changelog

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## Changed

- Refactor tables to respect `indent_size = 1`.

## Fixed

- Tables with `<tr>` and `<td>` tags in wrong ending order.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/627
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: Javier Pérez <walpo@noreply.codeberg.org>
Co-committed-by: Javier Pérez <walpo@noreply.codeberg.org>
2025-06-16 22:57:17 +02:00
Javier Pérez
e405ae93ae Lint the documentation (#626)
# Changelog

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## Removed

- Disable the Markdownlint rule MD024 (`Multiple headings with the same content`).

## Fixed

- Syntax errors in `.markdownlint.yaml`.
- Markdownlint issues:
  - Heading levels should only increment by one level at a time([MD001](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md001.md))
  - Hard tabs ([MD010](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md010.md))
  - Reversed link syntax ([MD011](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md011.md))
  - Dollar signs used before commands without showing output ([MD014](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md014.md))
  - Multiple top-level headings in the same document ([MD025](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md025.md))
  - Trailing punctuation in heading ([MD026](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md026.md))
  - Ordered list item prefix([MD029](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md029.md))
  - Emphasis used instead of a heading([MD036](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md036.md))
  - Fenced code blocks should have a language specified ([MD040](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md040.md))
  - Link fragments should be valid ([MD051](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md051.md))
  - Link text should be descriptive ([MD059](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md059.md))

- Prettier issues.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/626
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: Javier Pérez <walpo@noreply.codeberg.org>
Co-committed-by: Javier Pérez <walpo@noreply.codeberg.org>
2025-06-14 15:39:01 +02:00
Javier Pérez
c6ac9a9f94 Reduce line length limit and format content (#623)
# Changelog

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## Changed

- Update line length limit from 500 characters to 120 characters.

## Fixed

- Most instances of these lint issues:
  1. Lines longer than 120 characters ([MD013](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md013.md)).
  2. Trailing whitespaces ([MD009](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md)).
  3. Ordered list item prefix ([MD029](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md029.md)).
  4. Bare links ([MD034](https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md034.md)).

Co-authored-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/623
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: Javier Pérez <walpo@noreply.codeberg.org>
Co-committed-by: Javier Pérez <walpo@noreply.codeberg.org>
2025-06-14 11:38:21 +02:00
Ryuno-Ki
5e3c5b1bf3 Point to latest release (#622)
I noticed that Codeberg was referring to v1.19 of Forgejo.

Given that Forgejo's documentation is quite stable I feel like it
makes more sense to refer to the latest version of the docs instead.

Signed-off-by: Ryuno-Ki <andre.jaenisch@posteo.de>

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/622
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Ryuno-Ki <andre.jaenisch@posteo.de>
Co-committed-by: Ryuno-Ki <andre.jaenisch@posteo.de>
2025-06-11 12:20:59 +02:00
Seyed Mohamad Amin Modaresi
95ef240390 explain enabling repository releases (#597)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/597
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Seyed Mohamad Amin Modaresi <modaresisofthard@proton.me>
Co-committed-by: Seyed Mohamad Amin Modaresi <modaresisofthard@proton.me>
2025-06-10 18:51:17 +02:00
Panagiotis "Ivory" Vasilopoulos
3374948e11 Keycloak: Add organization owner note (#604)
Fixes https://codeberg.org/Codeberg/Documentation/issues/541

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/604
2025-05-27 18:31:30 +02:00
Alex
6c4867c76c codeberg-translate: describe direct push config option (#481)
Weblate can also be configured to push directly to the Codeberg repo
but that requires adding the `translate` user as a collaborator in the
respective repo.

Also use this opportunity to improve grammar/formulations.

Closes: #324

Co-authored-by: Gusted <postmaster@gusted.xyz>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/481
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Alex <alex@puer-robustus.eu>
Co-committed-by: Alex <alex@puer-robustus.eu>
2025-04-29 20:45:41 +00:00
yaroze
3468da80a4 Update documentation for enabling Forgejo Actions (#590)
Clarified where the user should Forgejo Actions.

Thanks to @gusted:matrix.org

Co-authored-by: plfarinha <plfarinha@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/590
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: yaroze <yaroze@noreply.codeberg.org>
Co-committed-by: yaroze <yaroze@noreply.codeberg.org>
2025-04-29 20:38:52 +00:00
Bene
20e5862bcf Pages: Add a warning that the availability is only best effort (#585)
I'm approaching the "transparency" proposal by @fnetX in Codeberg-e.V./Discussion#124

This should set the expectations of users using this feature to a more realistic setting (at least if they read the documentation). If this MR gets accepted, we can adapt the landing page afterward to include the same text.

cc @crapStone

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/585
Reviewed-by: Otto <otto@codeberg.org>
Reviewed-by: crapStone <codeberg@crapstone.dev>
Co-authored-by: Bene <bene64@posteo.de>
Co-committed-by: Bene <bene64@posteo.de>
2025-04-24 20:32:36 +00:00
crystal
9a55f7bf8b update Codeberg Pages IP addresses (#556)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/556
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: crystal <crystal@noreply.codeberg.org>
Co-committed-by: crystal <crystal@noreply.codeberg.org>
2025-04-23 13:43:54 +00:00
Gusted
ca2f628ce4 ci: update link (#551)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/551
2025-03-26 00:44:44 +00:00
ninthcircle
8649e50afa
fix: update instructions for adding custom key path in ssh-keygen (#535) 2025-02-22 21:17:35 +05:30
Panagiotis "Ivory" Vasilopoulos
89d1b10f9f Remove link to Codeberg chatroom (#529)
It is not possible to join the room directly anymore.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/529
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-committed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2025-02-05 08:16:21 +00:00
DeanLemans
8e0c2ce042 Forgejo is a hard-fork now (#526)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/526
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: DeanLemans <deanlemans@noreply.codeberg.org>
Co-committed-by: DeanLemans <deanlemans@noreply.codeberg.org>
2025-01-30 13:51:49 +00:00