dallasgroot/Documentation
1
0
Fork 0
mirror of https://codeberg.org/Codeberg/Documentation.git synced 2026-08-15 14:53:29 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions
734 commits 6 branches 0 tags 20 MiB
Commit graph

734 commits

This branch
This branch
All branches
Author SHA1 Message Date
Robert Wolff
31b3c1d7b4
fix: return back to knut/examples example 2026-07-17 12:54:02 +02:00
Robert Wolff
5fdd06105e
fix: push token always needs repository write access 2026-07-17 12:49:35 +02:00
Robert Wolff
16d8522d56
Merge branch 'main' into private_http_clone_merged_main 2026-07-17 12:48:50 +02:00
Mark Pitblado
1186f54db5
docs: add clone operation, wish -> want 2026-07-17 12:37:17 +02:00
Mark Pitblado
e7fe2eee03
docs: clarify oauth2 requirement and read/write 
Addresses feedback that oauth2 is not required, and that the token
itself can serve as the username. Clarifies that read access is all that
is required for fetching.
 2026-07-17 12:37:01 +02:00
Mark Pitblado
0e14351c66
put ssh section first and state as recommended 
also fixes url to URL and changes knut/example to user/repo
 2026-07-17 12:36:43 +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
b66be2d324 chore(deps): update dependency cspell to v10 (#847) 
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/847
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
 2026-07-13 05:56:48 +02:00
Dependency bot
0c940b7eca chore(deps): update font awesome to v7.3.0 (#846) 
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/846
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
 2026-07-13 05:56:36 +02:00
Dependency bot
039a9117a8 chore(deps): update pipelinecomponents/yamllint docker tag to v0.35.13 (#845) 
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/845
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
 2026-07-13 05:55:33 +02:00
Dependency bot
5f75a85132 chore(deps): update dependency @11ty/eleventy to v3.1.6 (#844) 
This PR contains the following updates:

| Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) |
|---|---|---|---|
| [@11ty/eleventy](https://www.11ty.dev/) ([source](https://github.com/11ty/eleventy)) | [`3.1.5` → `3.1.6`](https://renovatebot.com/diffs/npm/@11ty%2feleventy/3.1.5/3.1.6) | ![age](https://developer.mend.io/api/mc/badges/age/npm/@11ty%2feleventy/3.1.6?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/@11ty%2feleventy/3.1.5/3.1.6?slim=true) |

---

### Release Notes

<details>
<summary>11ty/eleventy (@&#8203;11ty/eleventy)</summary>

### [`v3.1.6`](https://github.com/11ty/buildawesome/releases/tag/v3.1.6): Eleventy v3.1.6: Everybody wants to do Maintenance

[Compare Source](https://github.com/11ty/eleventy/compare/v3.1.5...v3.1.6)

- Fixes Node 26 `module.register` deprecation warning shown in console [#&#8203;4283](https://github.com/11ty/eleventy/issues/4283) (fixed in v4 alphas in [#&#8203;4271](https://github.com/11ty/eleventy/issues/4271))
- Minor dependency upgrades for `npm audit` fixes
  - `liquidjs` upgrade from `1.25.0` to `1.27.0`
  - `markdown-it` upgrade from `14.1.1` to `14.2.0`
- Adds Node 26 to CI for v3 branch
- Opt out of package manager cache for GitHub Actions CI release workflow (hardening security)

**Milestone**: <https://github.com/11ty/eleventy/milestone/52?closed=1>
**Full Changelog**: <https://github.com/11ty/eleventy/compare/v3.1.5...v3.1.6>

</details>

---

### Configuration

📅 **Schedule**: (UTC)

- Branch creation
  - Only on Sunday and Saturday (`* * * * 0,6`)
- Automerge
  - Between 12:00 AM and 03:59 AM (`* 0-3 * * *`)

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4yNjAuMSIsInVwZGF0ZWRJblZlciI6IjQzLjI2MC4xIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJkZXBlbmRlbmN5Il19-->

Co-authored-by: woodpecker-bot <woodpecker-bot@obermui.de>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/844
 2026-07-13 05:54:52 +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
Dependency bot
7f3958fe80 chore(deps): update dependency pagefind to v1.5.2 (#840) 
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/840
 2026-07-12 03:01:07 +02:00
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