Commit graph

57 commits

Author SHA1 Message Date
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
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
Gusted
ad9e3c53e0 Make linters happy (#723)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/723
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2025-12-19 02:12:14 +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
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
Gusted
03342e98ec feat: use Eleventy's image plugin for image transformation (#488)
Use https://www.11ty.dev/docs/plugins/image/ to transform images on build time to avif, webp and jpeg.

Images are moved to `/content/images`.

`<picture>` is no longer needed, the plugin does this automatically.

Remove webp images from the source.

Resolves #152
Resolves #368

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/488
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2024-11-29 06:12:05 +00:00
pat-s
74e8925bec add spellchecker (#439)
fix #148

Adds a spell checker via `cspell` and fixes some spelling issues in the docs.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/439
Co-authored-by: pat-s <patrick.schratz@gmail.com>
Co-committed-by: pat-s <patrick.schratz@gmail.com>
2024-06-12 10:20:37 +00:00
crapStone
da1b77aa6a Add woodpecker ci & many linters (and their required fixes) (#377)
closes #238

Co-authored-by: pat-s <patrick.schratz@gmail.com>
Co-authored-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/377
Co-authored-by: crapStone <crapstone01@gmail.com>
Co-committed-by: crapStone <crapstone01@gmail.com>
2024-06-11 07:51:22 +00:00
Panagiotis "Ivory" Vasilopoulos
8386857b1c Use admonition boxes more consistently
- Formatting fixes, relevant text adjustments
- Some more complicated cases (e.g. attribution), as well as outdated
  information that should be removed in a later commit were
  deliberately left unchanged.
- Some minor mistakes (speling, trailing whitespaces, punctuation)
  in the admonition boxes were also fixed.
2023-11-27 07:16:04 +01:00
Panagiotis "Ivory" Vasilopoulos
37b507b6f7 Fix styling and factual errors in 'Repository Permissions' (#328)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/328
2023-07-20 21:46:54 +00:00
f0sh
77bfb6cc15 Change all Gitea references to Forgejo, fix #315 (#322)
Where possible, changed all references from Gitea to Forgejo.
Wherever documentation mentions specifically Gitea, it is preserved.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/322
Co-authored-by: f0sh <f0sh@mailbox.org>
Co-committed-by: f0sh <f0sh@mailbox.org>
2023-07-18 00:43:47 +00:00
f0sh
1984032bdd Add improvements to the Documentation according to open issues (#314)
Tried to close some open issues in the issue tracker by submitting the following changes as my first contribution to Codeberg:

 - added list on every section index page, should fix #63
 - added webhooks documentation, should fix #282
 - described behaviour of a limited user profile, should fix #279
 - added further explanation to 2fa section, according to Codeberg/Documentation#268, should fix #268
 - added codeberg badge generator to first-repository description, should fix #39
 - added dns record description to custom-domains, should fix #302
 - added description how to use 2fa with git, should fix #278
 - added and updated repo migration service description, should fix #312

Feedback highly appreciated.

Co-authored-by: f0sh <f0sh@mailbox.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/314
Co-authored-by: f0sh <f0sh@noreply.codeberg.org>
Co-committed-by: f0sh <f0sh@noreply.codeberg.org>
2023-07-08 16:27:44 +00:00
Felipe Leopoldo Sologuren Gutiérrez
98c40b8a07 Fixing broken links (#267)
Changes:
 * Fallback images links are all lowercase now.
 * Fix html redirect (meta tag http-equiv redirect) from ```/git/clone-commit-via-http ```to ```/git/clone-commit-via-web```.
 * Added protocol to an email link.
 * Fix some pages links.

To detect broken links I used wget:

```
wget --spider --recursive --level=0 --debug -e robots=off --base=http://localhost:8080 http://localhost:8080 2>&1 | grep ^Found\ [0-9]*\ broken\ link
```

However, wget detects html redirects (meta tag http-equiv refresh) as false positive.

If broken links have found, then the referer header will be searched for find out where they are:
```
wget --spider --recursive --level=0 --save-headers --debug -e robots=off --base=http://localhost:8080 http://localhost:8080 2>&1 | less
```

Co-authored-by: fsologureng <sologuren@estudiohum.cl>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/267
Co-authored-by: Felipe Leopoldo Sologuren Gutiérrez <fsologureng@noreply.codeberg.org>
Co-committed-by: Felipe Leopoldo Sologuren Gutiérrez <fsologureng@noreply.codeberg.org>
2022-10-03 21:35:01 +02:00
Jeremy
8b7b5ffcf8 Fix collaborating/resolve-conflicts.md 2022-07-26 21:46:39 +02:00
Jeremy
3fb270ad28 Fix collaborating/repo-permissions.md 2022-07-26 21:46:39 +02:00
Jeremy
bc300e5caa Fix collaborating/create-organization.md 2022-07-26 21:46:39 +02:00
Jeremy
fbd05b0037 Fix collaborating/invite-collaborators.md 2022-07-26 21:46:39 +02:00
Jeremy
db5724f0b9 Fix collaborating/pull-requests-and-git-flow.md 2022-07-26 21:46:39 +02:00
Jeremy
274558d54f Fix collaborating/citable-code.md 2022-07-26 21:46:39 +02:00
Jeremy
d1e4479d76 Fix collaborating/index.md 2022-07-26 21:46:39 +02:00
n
1ace475965 Switch Font Awesome to use SVG icons and update to v6 (#243)
This PR switches the Font Awesome icons to use SVG instead of a font, and updates it to v6.

~~Depends on Codeberg-Infrastructure/codeberg-fonts#13 getting deployed.~~ Now deployed.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/243
Co-authored-by: n <n@noreply.codeberg.org>
Co-committed-by: n <n@noreply.codeberg.org>
2022-07-09 12:52:21 +02:00
Jan Klippel
5a1fdc201e
Article on conflict resolution
Initial version of an article on conflict resolution

Fixes: #14
2022-05-28 16:30:19 +02:00
n
70f94b2ee0 Gender-neutral language 2022-03-07 02:53:13 +09:00
Gusted
de72273544
Apply code suggestions 2022-03-04 00:20:58 +01:00
Gusted
a53a187ee3
Rework the permissions article
- Rework the permission article, by splitting it into 2 new category's.
The current information would be within the Collaborators section, as
that hasn't changed. The new section is mostly concerned for the new
permissions system that is used for teams. It covers all the permissions
and values that can be selected.
- Resolves #204
2022-03-04 00:04:59 +01:00
René Schaar
fd44b5335f Add project overview table to the contributing code site (#203)
Fixes: #201
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/203
Co-authored-by: René Schaar <rene@schaar.priv.at>
Co-committed-by: René Schaar <rene@schaar.priv.at>
2022-02-26 10:46:22 +01:00
Otto Richter
2bda61e74d Diverse changes (#189)
a bunch of (typo) fixes, additions, rewordings

Update references

- remove mentions of the master branch, as it's removed for many repos
and might change in the future for others (fixes some dead links)
- remove mentions of moved repos with our official examples
- some on-the-fly additions or rewordings

Close #186 foobar->examples

Co-authored-by: fnetx <git@fralix.ovh>
Co-authored-by: fnetX <git@fralix.ovh>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/189
Co-authored-by: Otto Richter <fnetx@noreply.codeberg.org>
Co-committed-by: Otto Richter <fnetx@noreply.codeberg.org>
2022-01-21 11:36:38 +01:00
mike
da549f6a23 Fixes a single internal link to the Tag article (#169)
Co-authored-by: Michiel Appelman <michiel@appelman.se>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/169
Co-authored-by: mike <michielappelman@noreply.codeberg.org>
Co-committed-by: mike <michielappelman@noreply.codeberg.org>
2021-09-24 15:57:18 +02:00
n
288d5834af Another minor wording change 2021-08-20 17:27:58 +09:00
n
b1a71be11a Minor wording change. 2021-08-20 17:10:24 +09:00
Gerhard Beck
aaf58c97c4 Move Instructions on Creating a Release (#163)
Moving "releases in Codeberg" as discussed in https://codeberg.org/Codeberg/Documentation/issues/151

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/163
Co-authored-by: Gerhard Beck <gerhard.beck@elkb.de>
Co-committed-by: Gerhard Beck <gerhard.beck@elkb.de>
2021-08-20 10:09:04 +02:00
n
170914185d Add anchor links to headings (#159)
This PR adds anchor links to any markdown headings. It also replaces any hacky workarounds used previously.

Closes #83.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/159
Co-authored-by: n <n@noreply.codeberg.org>
Co-committed-by: n <n@noreply.codeberg.org>
2021-08-09 11:59:36 +02:00
n
d503814095 Add halfmoon class to all content titles 2021-07-27 02:08:30 +09:00
n
ae684fbad4 Migrate to Codeberg Design Kit (#132) (#149)
TODO:
- [x] Hide navbar items on small screens
- [x] Fix `<blockquote>` rendering
- [x] Fix `<code>` rendering
- [ ] LibreJS Compatibility

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/149
Co-authored-by: n <n@noreply.codeberg.org>
Co-committed-by: n <n@noreply.codeberg.org>
2021-07-26 12:07:23 +02:00
Lucas Hinderberger
1557f2b3d8 Fixing section order collisions 2021-07-11 15:01:01 +02:00
William Davis
506c6a4c90 Tags and Releases Documentation (#106)
Co-authored-by: unbeatable101 <unbeatable101@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/106
2021-03-06 18:51:08 +01:00
Lucas Hinderberger
a20230f555 Merge branch 'resolve-merge-conflict' 2020-10-16 17:36:13 +02:00
Lucas Hinderberger
5e2a1ce0e8 Merge pull request 'Collaborators and Organizations' (#82) from ivan-paleo/Documentation:collabo-orga into master
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/82
2020-10-16 17:17:28 +02:00
Martijn de Boer
e64721c5d6
Collaborating; just a single typo 2020-10-16 16:40:22 +02:00
Ivan Calandra
5da9a8c605 Spell out eleventy key 2020-10-16 14:53:27 +02:00
Ivan Calandra
ca0d41948f permissions for repo and org 2020-10-15 10:46:57 +02:00
Ivan Calandra
2a7ceacdb3 New table of access rights 2020-10-12 10:23:19 +02:00
Ivan Calandra
b4f81deba2 2nd round of edits (not finalized) 2020-10-01 18:46:19 +02:00
ivan-paleo
d2bc1a8c6d Citable Code (#81)
Co-authored-by: Ivan Calandra
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/81
2020-09-30 12:26:08 +02:00
Ivan Calandra
78b0cb2541 Add table of access rights 2020-09-30 11:58:10 +02:00
Ivan Calandra
104f25cb51 Changes requested by lhinderberger
(table missing... next commit)
2020-09-30 08:48:58 +02:00
Ivan Calandra
9ceb5b379a invite-collaborators.md
Changes requested by lhinderberger
2020-09-29 16:45:55 +02:00