0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-24 18:09:26 -05:00
Commit graph

160 commits

Author SHA1 Message Date
Oto Šťáva
681f3a8369
Unify Alpine versions across the repo
This mainly came about because I noticed an inconsistency in the
`docs/user/actions.md` section, where it said a snippet ensures the usage
of _Alpine 3.18_, but the snippet actually obviously said _3.19_.

While I was at it, I just updated all mentions of Alpine I could find to
the current _3.20_.
2024-11-22 10:41:08 +01:00
dcz_pf
2bb8cbc603 Clarify API token usage (#939)
The config section can be easily missed when someone intends to only use the token as an env var. But that section contains the crucial bit of information about formatting the token.
This splits the credentials info from configuration description and makes the format explicit. While at it, the necessary permission is highlighted.

This should fix Codeberg/Community#1701

Co-authored-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/939
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: dcz_pf <cobepfac.dcz@porcupinefactory.org>
Co-committed-by: dcz_pf <cobepfac.dcz@porcupinefactory.org>
2024-11-21 18:25:56 +00:00
julianfoad
953989cd7e docs: api-usage: tokens need 'scopes'
Document the "scopes" field that is now required when generating API tokens. Refer to the documentation of scope names.

Signed-off-by: julianfoad <julian@foad.me.uk>
2024-11-14 16:31:21 +00:00
cascading-pr
a7f8c36652 cascading-pr update 2024-11-10 12:17:16 +00:00
Ainsley Ellis
8418b8bd50 Fix broken links 2024-10-02 22:34:01 -04:00
0ko
f45dc35837 user: arch package: fix typo, fix wrong link 2024-09-29 06:42:54 +00:00
ExplodingDragon
577e8791c3
supprt arch delete by arch 2024-09-27 09:44:59 +08:00
Kwonunn
d88ef00889 Fix copying mistake 2024-09-23 07:58:10 +00:00
Earl Warren
1a72849b87 user: OAuth2 section title typo 2024-09-16 11:58:33 +00:00
Malte Jürgens
830595982f
Add Tags and Releases page
This has been adapted from
https://codeberg.org/Codeberg/Documentation/src/branch/main/content/git/using-tags.md,
and updated to document the changes from
https://codeberg.org/forgejo/forgejo/pulls/1445.

Co-authored-by: n <n@noreply.codeberg.org>
Co-authored-by: Gerhard Beck <gerhard.beck@elkb.de>
Co-authored-by: Jeremy <jeremytbaxter@protonmail.com>
Co-authored-by: Jeremy <jtbx@duck.com>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: William Davis <unbeatable-101@noreply.codeberg.org>
Co-authored-by: crapStone <crapstone01@gmail.com>
Co-authored-by: f0sh <f0sh@mailbox.org>
Co-authored-by: fnetx <git@fralix.ovh>
Co-authored-by: mutluyuz <mutluyuz@noreply.codeberg.org>
Co-authored-by: n0toose <git@n0toose.net>
2024-09-08 19:39:34 +02:00
Mai-Lapyst
000ca5ab42 Reword how custom values for the shell prop work 2024-09-04 23:05:30 +00:00
Mai-Lapyst
5d576d8b3c Document better how the shell prop in steps work 2024-09-04 23:05:30 +00:00
mahlzahn
7c5ef2e7e2 Fix location of gitconfig user file 2024-09-04 21:44:56 +00:00
Gusted
0fe4007f5c Add documentation for pushmirror via SSH
- Refs: forgejo/forgejo#4819
2024-08-26 08:06:56 +00:00
0ko
c9eba3bf30 user: actions: replace manpage provider for crontab 2024-08-21 20:58:41 +05:00
Radosław Piliszek
e82255b9bf agit: replace the "complex" example
There was a lot of false information in that section and the
examples did not do what was described in the text.

This change extracts the perhaps-useful reminder that push still
behaves like push and allows to specify arbitrary local references.

Some points to note (which were wronged previously):

* refspec for push has the dst part optional, not the other way
  around (and it's thus either `src` or `src:dest` in syntax)
* HEAD always points to the checked-out reference, so all examples
  were still pushing the checked-out reference
2024-08-16 12:25:34 +00:00
RobertoMaurizzi
c1aec9211e tell users where to write the variables 2024-08-13 03:43:41 +00:00
dragon
4a627a2fec add arch package doc (#791)
This is the documentation for PR https://codeberg.org/forgejo/forgejo/pulls/4785.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/791
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: dragon <explodingfkl@gmail.com>
Co-committed-by: dragon <explodingfkl@gmail.com>
2024-08-05 04:58:09 +00:00
mahlzahn
ce7ca34bcb Fix label application instructions 2024-07-31 22:47:28 +00:00
Twenty Panda
46a3f68002 user: actions: add on.issues 2024-07-22 12:19:31 +02:00
Mai-Lapyst
3817c7f5e2 Document the on.workflow_dispatch event trigger 2024-07-14 10:37:23 +00:00
Shiny Nematoda
9f420e366b user(code search): mention branch/tag dropdown 2024-07-02 08:16:24 +00:00
cascading-pr
7c7a6cfe12 cascading-pr update 2024-06-24 13:43:55 +00:00
avobs
866d79d0fe Update docs/user/blocking-user.md (#677)
Spamming a repository is only meaningful in the issues.

https://forgejo.codeberg.page/@docs_pull_677/docs/next/user/blocking-user/
Co-authored-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/677
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: avobs <avobs@noreply.codeberg.org>
Co-committed-by: avobs <avobs@noreply.codeberg.org>
2024-06-24 11:37:17 +00:00
Twenty Panda
7e60f058d1 user: actions: add examples to the cache 2024-06-22 20:25:39 +00:00
Ikuyo Kita
b2c12f3897 user: issue-tracking-basics: correct some parts 2024-06-22 20:01:57 +00:00
Shiny Nematoda
9a59b851f3 Add screenshots for code search (#715)
reflect changes made in forgejo/forgejo#4134

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/715
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Shiny Nematoda <snematoda.751k2@aleeas.com>
Co-committed-by: Shiny Nematoda <snematoda.751k2@aleeas.com>
2024-06-22 20:01:14 +00:00
kita
7c3b81ec99
user: first-repository: update screenshots and content 2024-06-14 16:13:27 +08:00
Earl Warren
11859284af user: oauth2: illustrated example to add an authentication source (#703)
Preview: https://forgejo.codeberg.page/@docs_pull_703/docs/next/user/oauth2-provider/#using-a-codeberg-as-an-authentication-source
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/703
Reviewed-by: twenty-panda <twenty-panda@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2024-06-13 15:33:51 +00:00
Earl Warren
6fa1c28677 user: actions: document the default for shell
`jobs.<job_id>.steps[*].shell` defaults to `bash` unless
`jobs.<job_id>.container.image` is specified in which case it defaults
to `sh`.

Refs: https://code.forgejo.org/forgejo/runner/issues/150
2024-06-08 04:58:24 +00:00
adagio
c86099d84e
Updates whitelist to allowlist 2024-06-01 21:26:59 -04:00
adagio
8ba517004d Fixes broken links (#675)
Preview: https://forgejo.codeberg.page/@docs_pull_675/docs/next/user/first-repository/

Redirect links as reported:

https://codeberg.org/forgejo/docs/issues/674
https://codeberg.org/forgejo/docs/issues/673
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/675
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-05-31 11:50:41 +00:00
adagio
d141e54597 Modifies and reformats actions.md glossary (#630)
Adds contents to the glossary section of the `actions.md` file.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/630
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-05-30 05:54:01 +00:00
Earl Warren
6b6f79e6ff user: actions: indent issue 2024-05-28 20:58:30 +00:00
Schiriki
c46f6bc4af
Replace gitea through forgejo 2024-05-28 00:21:02 +02:00
Abdur-Rahman Mansoor
ed5886012a style: fix more typos in /docs/user 2024-05-26 10:47:47 +00:00
Abdur-Rahman Mansoor
5c52eddd34 style: fix typos and use american spelling convention in some areas (#647)
You'll notice that asides from some typo fixes, "organisation" has been changed to "organization" to ensure a more consistent style guide, adapted to Codeberg's style: https://docs.codeberg.org/improving-documentation/style-guide/

Also changed "orgs" to "organizations" as it's more professional and easier to understand.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/647
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
Co-committed-by: Abdur-Rahman Mansoor <armansoor@missingno.dev>
2024-05-25 14:28:28 +00:00
Matthias Ahouansou
5c634782b9
Add guide to set branch to push to AGit pull request by default 2024-05-25 10:37:46 +01:00
Shiny Nematoda
970f8a24f0 update code search (forgejo/forgejo#3654) 2024-05-17 10:44:54 +00:00
adbagio
f5b51da942 adds and updates hierarchy section 2024-05-16 07:40:42 +00:00
jwildeboer
784e395e97 Update Issue/PR Template doc (#609)
Preview: https://forgejo.codeberg.page/@docs_pull_609/docs/next/user/issue-pull-request-templates/#directory-names

Proposal based on https://codeberg.org/forgejo/docs/issues/607 to make the docs more readable and add the `.forgejo` directory. Also added the `ref` and `labels` options to the yaml example.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/609
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: jwildeboer <jwildeboer@noreply.codeberg.org>
Co-committed-by: jwildeboer <jwildeboer@noreply.codeberg.org>
2024-05-12 18:43:11 +00:00
cascading-pr
131300c912 cascading-pr update 2024-05-10 05:39:23 +00:00
Yaroslav Halchenko
9ad5f2ab0f Add codespell support (without CI) and make it fix some typos (#536)
Per "request" of @0ko in https://codeberg.org/forgejo/forgejo/pulls/3270#issuecomment-1774032

TODOs
- postponed: how to add codespell (written in Python) to CI -- separate workflow? add to some other step? to some other tool/specification?

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/536
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Yaroslav Halchenko <debian@onerussian.com>
Co-committed-by: Yaroslav Halchenko <debian@onerussian.com>
2024-05-05 14:53:04 +00:00
0ko
4cba3d36b3 Fix dead links 2024-05-05 06:18:43 +00:00
OniriCorpe
cd06bf37c5 Fix the 'Forgejo numbering scheme' link 2024-05-02 23:52:48 +00:00
Firepup650
a1106f2fce Fix a broken link
`[clean up job]../../admin/config-cheat-sheet/#cron---cleanup-expired-packages-croncleanup_packages)` -> `[clean up job](../../admin/config-cheat-sheet/#cron---cleanup-expired-packages-croncleanup_packages)`
2024-04-28 14:55:54 +00:00
Robin Kloppe
d9db0d13f6 Added Repo Mirros (#568)
In a next step https://codeberg.org/forgejo/forgejo/pulls/3503 can be merged

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/568
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Robin Kloppe <git@mainboarder.de>
Co-committed-by: Robin Kloppe <git@mainboarder.de>
2024-04-28 08:58:32 +00:00
cascading-pr
ef11b41eb5 cascading-pr update 2024-04-25 13:40:26 +00:00
Earl Warren
a0477a8300 LTS: is not part of the metadata & CLI updates (#561)
- LTS are listed in the table, no hint in the version number
- update the RC release names
- CLI updates

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/561
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2024-04-23 15:57:31 +00:00
Earl Warren
cd3c76c05d docs: user: new section on comment on issues & PR via email 2024-04-23 09:03:49 +00:00