Commit graph

712 commits

Author SHA1 Message Date
Dependency bot
963a352dc7 chore(deps): lock file maintenance (#776)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/776
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-12 02:14:26 +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
mahlzahn
c5873b5010 fix: make linters happy (#835)
Missed in !834

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/835
2026-07-09 20:46:50 +02:00
mahlzahn
1fb1c234f4 fix(ci): temporary workaround for preview deletion (#834)
Related: Codeberg/Documentation#818, git-pages/git-pages-cli#44

May be reverted once the upstream issue is fixed.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/834
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-09 19:07:03 +02:00
Gusted
3c1f8948e5 Blue navbar (#833)
Part of the identity.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/833
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
2026-07-09 15:46:01 +02:00
Dependency bot
93003332aa chore(deps): update dependency @uncenter/eleventy-plugin-toc to v2 (#830)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/830
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-08 18:16:37 +02:00
Dependency bot
275d959b8b chore(deps): update dependency markdown-it to v14.2.0 [security] (#828)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/828
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-08 17:05:12 +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
Dependency bot
0b1180bafd chore(deps): update dependency pnpm to v11 [security] (#829)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/829
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-07-08 16:54:43 +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
Robert Wolff
372d3aa75e fix(ci): typo (#817)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/817
2026-06-26 11:36:47 +02:00
Robert Wolff
b11b3c8463 feat(ci): delete preview on closing a pull request, update plugin (#816)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/816
2026-06-26 11:32:22 +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
Robert Wolff
6b473d4a0f feat(ci): pin docker images to SHA256 checksum (#814)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/814
2026-06-25 16:44:09 +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
Robert Wolff
e9fee7f014 fix(ci): publish preview only when build done, save CI: don't build twice, remove not working expiration (#812)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/812
2026-06-25 13:32:41 +02:00
Robert Wolff
3fabaf196c feat: use git-pages for pull request previews (#810)
Follow-up of Codeberg/Documentation!713

Co-authored-by: Gusted <postmaster@gusted.xyz>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/810
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-06-25 12:12:36 +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
Dependency bot
c99ae24d80 chore(deps): update mstruebing/editorconfig-checker docker tag to v3.6.1 (#769)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/769
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Dependency bot <renovate-bot@noreply.codeberg.org>
Co-committed-by: Dependency bot <renovate-bot@noreply.codeberg.org>
2026-04-18 15:34:16 +02:00
Dependency bot
3d2f8779ba chore(deps): update dependency cspell to v9.8.0 (#770)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/770
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Dependency bot <renovate-bot@noreply.codeberg.org>
Co-committed-by: Dependency bot <renovate-bot@noreply.codeberg.org>
2026-04-18 15:33:00 +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