Commit graph

495 commits

Author SHA1 Message Date
gedankenstuecke
913b9fd0ea adds missing re-adding of origin to repo cleaning (#874)
The missing bit was [identified in the Codeberg e. V. member forum](https://forum.codeberg.org/d/265-problems-regarding-the-instructions-in-reducing-the-size-of-a-repository), this just adds the remote that gets removed back in.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/874
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-08-14 15:14:13 +02:00
crystal
3c0a989b46 add notice about multiple webhooks for pages custom domains (#869)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/869
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-08-08 11:21:33 +02:00
Robert Wolff
a310584781 fix(ci): ignore FSF links for link checking (#870)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/870
2026-08-08 11:20:54 +02:00
Gusted
0e890f95df Avoid help@codeberg.org mail (#860)
To my knowledge this is not being attended by anyone, contact@ is/was the preferred way for general questions and help. This is the only reference left of what I can find.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/860
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-08-02 21:34:26 +02:00
Artyom Bologov
6a78a4c7d8 Try fixing CI (#857)
This is an attempt to try fixing CI errors, as seen in 38dd33d Woodpecker run. Might not be complete, but the only thing missing is Apple Authenticator link fix, which is flaky.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/857
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-25 21:17:20 +02:00
Artyom Bologov
38dd33db6c pages: git-pages changes and troubleshooting (#854)
Hi! This updates Pages docs with more details on git-pages quirks and troubleshooting.

Adapted from https://aartaka.me/codeberg-pages.html#git-pages

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/854
Reviewed-by: Catherine <whitequark@whitequark.org>
2026-07-25 19:04:41 +02:00
Dan Volchek
647637a7c6 pages: add info about test delivery button not working for pages webhook verification (#853)
Added a warning about the test delivery button being misleading for verifying pages webhook setup.

When pressed on a correctly configured webhook, it results in an error: `401 ref refs/heads/main not in allowlist [refs/heads/pages]`. This is both confusing and misleading; changing the branch filter also doesn't fix it.

I was helping a friend set up a pages site and we ran into this and were stuck until we guessed that the test itself doesn't work.

The docs don't explicitly say to use the test delivery button, but it is *right there* so we assumed we should use it. I think a note about not using it would help.

ty codeberg ur great

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/853
Reviewed-by: Catherine <whitequark@whitequark.org>
2026-07-21 16:03:53 +02:00
Zearin
539d032294 Minor copy-edits and formatting tweaks to Repo Permissions article (#849)
Just some trivial copy-edits to punctuation and formatting.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/849
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-17 19:52:36 +02:00
Robert Wolff
13db526474 add instructions for how to clone a private repository from the command line (#848)
Rebased and fixed version of !459

Co-authored-by: Mark Pitblado <mark@pitblado.me>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/848
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-17 16:25:54 +02:00
Iridium13
246a9e43de Just some minor tweaks to spelling, phrasing etc. (#753)
Co-authored-by: Robert Wolff <mahlzahn@posteo.de>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/753
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-17 12:28:14 +02:00
crystal
b061608a89 use example.org for pages documentation (#838)
We should consistently use a safe example domain that is [reserved by IANA](https://www.iana.org/help/example-domains)

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/838
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-15 14:43:57 +02:00
Arbor
bbf5e3ab10 docs: Add tip for first time SSH connection (#843)
This adds a tip for users connecting to Codeberg for the first time that they may need to verify the host fingerprint.

Closes: Codeberg/Documentation#832

Co-authored-by: arbor <arbor@woodsprite.dev>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/843
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-13 10:40:26 +02:00
Dependency bot
a8f296562d chore(deps): update dependency prettier to v3.9.4 (#841)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/841
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-13 00:45:22 +02:00
crystal
a973f58c31 DNSSEC clarifications (#837)
Missed a spot in #836 because DNSSEC was spelled weird. Also moved the
useful link to the DNSSEC verification tool to more relevant secions.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/837
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-12 01:23:29 +02:00
crystal
f350065a74 codeberg.page zone is now signed (#836)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/836
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-10 19:50:03 +02:00
Dave Anselmi
7e937e2088 Fix incorrect license recommendation. Closes #468 (#746)
See https://spdx.org/licenses/BSD-3-Clause-Clear.html and
https://opensource.stackexchange.com/questions/7559/patent-rights-bsd-3-clause-clear-vs-bsd-3-clause.

Co-authored-by: David Anselmi <danselmi@intecrowd.com>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/746
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-09 22:48:06 +02:00
Catherine
bd6a8cbbc0 Fix syntax of ALIAS DNS records. (#827)
These do not have @ automatically appended, so no need for a trailing
dot.

Closes: Codeberg/Community#2833
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/827
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-08 16:55:45 +02:00
timcl
25f21f69ff SSH-Key clip recommendations do not work with powershell (#824)
[https://docs.codeberg.org/security/ssh-key/](https://docs.codeberg.org/security/ssh-key/) currently recommends this: `clip < ~/.ssh/id_ed25519.pub` for copying on windows. This however breaks with pwsh (which is becoming more and more the default on windows) with:  *The '<' operator is reserved for future use.*
This pr adresses this by proposing `gc ~/.ssh/id_ed25519.pub | clip` for pwsh.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/824
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-07 13:47:08 +02:00
Catherine
9b655b9b37 Add more explanation for git-pages/action server: option. (#826)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/826
Reviewed-by: crystal <crystal@noreply.codeberg.org>
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
2026-07-05 02:33:49 +02:00
whitequark
33094726bb Add server: codeberg.page to Forgejo Actions Pages deployment example (#825)
This should reduce support load for first-deployment TLS issues.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/825
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
2026-07-04 22:07:53 +02:00
Thomas JOUANNOT
bcda6d99c5 feat(lfs): added troubleshooting section with some help regarding ssh (#820)
Today i encountered an issue while trying to push some lfs files to Codeberg: it would systematically fail.
After looking around I found this issue on Github: https://github.com/git-lfs/git-lfs/issues/6043
And I thought it would be nice to have it mentioned in the documentation :)

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/820
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-06-30 00:52:16 +02:00
Gusted
a76b575339 Update CAA recommendation (#822)
Caddy will first try against staging, so this also requires a CAA record.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/822
2026-06-30 00:49:18 +02:00
Gusted
05b677d374 Spelling 2026-06-30 00:49:06 +02:00
Gusted
5a28ff377f Extra detail in custom domains deployment via webhooks
First deployment needs to happen over HTTP.
2026-06-30 00:46:57 +02:00
David Anselmi
9868a2e150 Clarify ssh-keygen use. (#807)
Closes #411. I don't think a larger change is warranted here. The directions provided by settings/keys could be better but that's a separate issue (probably for Forgejo). Thanks!

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/807
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-06-28 00:11:20 +02:00
crystal
9ef2d7113b Clarify stuff about custom domains across pages docs (#819)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/819
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Reviewed-by: Catherine <whitequark@whitequark.org>
2026-06-26 20:09:04 +02:00
jarrodlovas
1ef2d6fae7 docs: Updated git config command examples, outlining those commands have changed and also added a warning for users to consider migrating to the new command syntax (#802)
Updated git config syntax and added a warning for users that it's recommended to migrate to the new syntax.
This was suggested in issue #756.

Closes: #756
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/802
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-06-25 21:31:22 +02:00
Gusted
e8045ed1b0 Update Apple store link to Authenticator (#815)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/815
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-06-25 16:49:01 +02:00
Kevin Ernst
18cbfe76e8 Add more complete examples to Markdown preformatted text sections (#805)
Inline `code spans` are now mentioned alongsize bold and italics where it makes the most sense to have them, and the preformatted text document has been updated to show the raw Markdown for each example. Each of these documents also cross-references the other, as an aid to the reader.

Several sections in `preformatted-text.md` have been renamed for clarity, with  `<a id="old-section-title"></a>` anchors such that inbound links with [fragment identifiers](https://en.wikipedia.org/wiki/URI_fragment#Basics) (direct section links) should not break as a result.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/805
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-06-25 14:03:45 +02:00
emholt1
e5f59881ed Fix some difficult to read text in the section on generating SSH keys (#764)
I’ve largely put down the torch of software development, but I use Codeberg for Nix and it feels wrong to use it without at least helping in some way.

Some language in the SSH key section can be easily misrepresented by skimming (e.g. the command to generate the key twice can lead newbies to maybe think they’d have to generate a public and private key seperately.)

Co-authored-by: Robert Wolff <mahlzahn@posteo.de>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/764
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-06-25 11:27:00 +02:00
Daeraxa
0c98b55b39 Add web interface fork sync section (#791)
This came from the fact that on GitHub I'm used to seeing the option to sync a forked repo all the time. But whilst looking for the same thing on Codeberg I couldn't find it and searching the docs for `sync` didn't return anything either.

The additions in this PR are fairly conservative. Rather than rewording anything I've just added a section about how to accomplish the same thing as above but via the web interface instead of via git.

The other small change is an update to an image for making a PR from a branch which I'm assuming is older version of the UI as I couldn't even find the button that looked like that.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/791
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-06-25 11:09:23 +02:00
lukaesque
c6790fce9a Clarifying who can see private repositories (#803)
I think that for someone just reading through the docs seeing "If you do not want **anyone** (apart from your fellow collaborators) to see your repositories" can very much sound like they're stored with "zero-knowledge", while finding the details in Codeberg's privacy policy is quite simple, there's no harm in making it clear in the docs as well.

Co-authored-by: Robert Wolff <mahlzahn@posteo.de>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/803
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-06-25 09:52:24 +02:00
Robert Wolff
1da2b7f99c fix(ci): resolve some links, replace other (#809)
Follow-up of https://codeberg.org/Codeberg/Documentation/pulls/808#issuecomment-17711441

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/809
2026-06-25 09:23:13 +02:00
Daphne Preston-Kendal
c44af653ff Update Codeberg Pages docs for git-pages custom domain support (#796)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/796
Reviewed-by: Catherine <whitequark@whitequark.org>
2026-06-25 09:15:27 +02:00
David Anselmi
d3328f739a Add translation section to improving-codeberg. (#808)
@n0toose [said](https://matrix.to/#/!uoDMoeuJJrVWEaCpSV:matrix.tu-berlin.de/$TwrNcEd59lymjoFYvCsFvlLuIlLO0bdvraAm713N3sc?via=freeyourgadget.org&via=matrix.org&via=tchncs.de) we could use this so here it is.

Please suggest how it could be better. Thanks!

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/808
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2026-06-19 08:12:30 +02:00
Octavia Togami
af57efaef1 Change his/her & his to their in licensing.md (#801)
This is consistent with the rest of the document and is more inclusive.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/801
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-06-07 20:46:44 +02:00
0ko
d7889e5ad6 fix: serve halfmoon css through addPassthroughCopy (#799)
Serve halfmoon CSS files through eleventry's addPassthroughCopy instead of template file, avoiding serving additional HTML bloat.

Network usage wise, this changes from one 423 KiB uncompressed response to two responses 380 KiB total

Followup to https://codeberg.org/Codeberg/Documentation/pulls/655
Solves https://codeberg.org/Codeberg/Documentation/pulls/655#issuecomment-7361962

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/799
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-05-31 14:50:19 +02:00
wetneb
e0fe2eaa66 Remove docs of org members management (#772)
Integrates the changes of forgejo/forgejo#11848.
This would also deserve new screenshots, I'm considering how best to refresh them (see discussion in the PR).

This probably shouldn't be merged before Codeberg updates to Forgejo 15, since users will still be confronted to the old UI in the meantime.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/772
Reviewed-by: Otto <otto@codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-05-21 20:39:45 +02:00
Panagiotis "Ivory" Vasilopoulos
0829806f6a Merch: Improve Markdown formatting 2026-05-12 00:32:23 +02:00
Panagiotis "Ivory" Vasilopoulos
db67c0260a Merch: Fix typos, CI failure
Sorry!
2026-05-11 09:53:32 +02:00
Panagiotis "Ivory" Vasilopoulos
003a0cb1ce Add Merch section (#788)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/788
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
2026-05-11 09:09:25 +02:00
litekin
16b319a3d8 an website -> a website (#785)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/785
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-05-05 10:50:19 +02:00
mukunda katta
64e97c1190 docs: clarify HTTPS auth with 2FA (#784)
## Summary
- clarify that HTTPS Git auth should use an access token as the password when 2FA is enabled
- update both the first repository guide and the CLI clone/commit guide for consistency

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/784
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-05-05 10:41:45 +02:00
Robert Wolff
5b48c54304 fix(ci): make prettier, lychee and cspell happy (#782)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/782
2026-04-28 12:04:20 +02:00
Dave Anselmi
8215c254bc Move duplicate article list snippets to shortcode. (#780)
Closes #335.

This is my first attempt coding for eleventy/liquid so I'd be happy to get feedback on making the code cleaner or more idiomatic, or just more like the Codeberg style.

Co-authored-by: David Anselmi <danselmi@intecrowd.com>
Co-authored-by: Gusted <postmaster@gusted.xyz>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/780
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-04-27 14:36:08 +02:00
RurPet
2695431962 fix: added comma because the phrasing might be confusing without (#779)
SourceHut: A minimum-GUI Free Software based service at first read as "minimum and GUI free and it's software based", which might be confusing for some people and is not intended
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/779
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-04-21 23:35:59 +02:00
kairusds
c2652bb941 Add version constraint for woodpeckerci/woodpecker-agent Docker image (#777)
* Add 443 port for WOODPECKER_SERVER environment  variable to fix edge cases of SSL errors occuring

Signed-off-by: kairusds <kairusds@noreply.codeberg.org>

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/777
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: kairusds <kairusds@noreply.codeberg.org>
Co-committed-by: kairusds <kairusds@noreply.codeberg.org>
2026-04-18 15:39:21 +02:00
leeroyjankins
047aa55ba0 Recommend forgejo-cli instead of codeberg-cli in the section on CLI clients (#773)
Since [codeberg-cli](https://codeberg.org/Aviac/codeberg-cli) has been discontinued, update the section on CLI clients to recommend forgejo-cli, which the codeberg-cli maintainer endorses.

Given the endorsement, I presume that it's worth recommending in the docs, even though the project is relatively young. Having used it myself, I can vouch for it.

I wrote a brief overview of forgejo-cli to contrast it slightly with `tea`.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/773
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: leeroyjankins <hatemail@jank.wtf>
Co-committed-by: leeroyjankins <hatemail@jank.wtf>
2026-04-09 11:00:42 +02:00
Abdur-Rahman Mansoor
2ace081a8d fix typo in using-custom-domain.md (#774)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/774
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
Co-committed-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
2026-04-03 15:13:32 +02:00
spuzkov
d11f27378f Updated the way git signing commands are shown (#762)
### Description

This fixes #761, more specifically the part (2) of their issue post. The issue was that it was not clear that the "." at the end of the command was meant to be excluded. Even if its clear to some, accidental copy and paste with the inclusion of "." have happened. Therefore, this PR is more of an improvement to the so called "quality of life".

**The fix**

Separating the commands in to code blocks and excluding the "." from the end.

**Other additions**

- The commands are also now described.
- A new command that allows users to check their current configuration in order to verify that things are as they intended. This commands

Source for both of these additions is:  https://janik6n.net/posts/signing-git-commits-with-ssh-key/

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/762
Co-authored-by: spuzkov <spuzkov@tuta.com>
Co-committed-by: spuzkov <spuzkov@tuta.com>
2026-04-02 03:59:09 +02:00