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

252 commits

Author SHA1 Message Date
Loïc Dachary
69843f60cd
docs: admin: storage: do not document [storage.XXXX]
its behavior is not thoroughly tested and varies in ways that are confusing
2023-08-13 17:12:51 +01:00
Loïc Dachary
c06a49e81c
docs: admin: storage: the defaut root for storage is APP_DATA_PATH 2023-08-13 17:12:51 +01:00
Earl Warren
ab0782c39c
docs: developer: workflow: requirement for Forgejo database migrations
While feature branches may have different requirements for the Forgejo
tables, they are constrained by the migration logic that requires they
happen in sequence and are listed in the same list. If each feature
branch changes the `forgejo_migrations/migrate.go` file independently,
it is bound to conflict with other feature branches trying to do the
same.

To avoid this situation it is proposed that once a migration
developped and tested in a freature branch is final, it is isolated in
a commit and moved to the `forgejo-development` branch. This can
happen during a rebase or with a pull request.

It is probably better that all migrations are ultimately squashed in a
single commit in the `forgejo-development` branch instead of an ever
growing list of commits. But this is up to the person in charge of the
migrations and since the directory is owned by forgejo, there is no
risk of conflict.
2023-08-13 17:10:14 +01:00
Earl Warren
2f75787cf8
docs: developer: workflow: no per-branch backports
Since the new release process involves using a single branch for
stable branches, the backport is no longer done on a per-branch basis.
2023-08-13 17:10:14 +01:00
Earl Warren
d1b6f00b45
docs: admin: storage: create a new section 2023-08-13 17:10:14 +01:00
Earl Warren
bb6b1a39b5
docs: admin: config-cheat-sheet: workers are dynamic now 2023-08-13 17:10:14 +01:00
Earl Warren
b6b56cd620
docs: admin: config-cheat-sheet: remove spurious line 2023-08-13 17:10:14 +01:00
Caesar Schinas
e688f3324b
fix: remove h1-level headings in docs
Increases depth of markdown headings to avoid 1st-level headings

# Conflicts:
#	v1.19/user/project.md
#	v1.19/user/protection.md
#	v1.19/user/push-to-create.md
2023-08-13 17:08:33 +01:00
Earl Warren
85a71e3c09
docs: admin: installation fix broken link
Fixes: https://codeberg.org/forgejo/website/issues/324
2023-08-13 17:07:45 +01:00
Caesar Schinas
9af05bfb01
refactor: use astro content collections for docs
Reviewed-on: https://codeberg.org/forgejo/website/pulls/323

# Conflicts:
#	v1.19/admin/command-line.md
#	v1.19/admin/config-cheat-sheet.md
#	v1.19/admin/database-preparation.md
#	v1.19/admin/email-setup.md
#	v1.19/admin/incoming-email.md
#	v1.19/admin/index.md
#	v1.19/admin/logging-documentation.md
#	v1.19/admin/reverse-proxy.md
#	v1.19/admin/seek-assistance.md
#	v1.19/admin/upgrade.md
#	v1.19/developer/code-forgejo-org.md
#	v1.19/developer/index.md
#	v1.19/index.md
#	v1.19/license.md
#	v1.19/user/agit-support.md
#	v1.19/user/api-usage.md
#	v1.19/user/authentication.md
#	v1.19/user/email-settings.md
#	v1.19/user/first-repository.md
#	v1.19/user/index.md
#	v1.19/user/issue-pull-request-templates.md
#	v1.19/user/issue-tracking-basics.md
#	v1.19/user/labels.md
#	v1.19/user/linked-references.md
#	v1.19/user/merge-message-templates.md
#	v1.19/user/oauth2-provider.md
#	v1.19/user/packages/cargo.md
#	v1.19/user/packages/chef.md
#	v1.19/user/packages/composer.md
#	v1.19/user/packages/conan.md
#	v1.19/user/packages/conda.md
#	v1.19/user/packages/container.md
#	v1.19/user/packages/generic.md
#	v1.19/user/packages/helm.md
#	v1.19/user/packages/index.md
#	v1.19/user/packages/maven.md
#	v1.19/user/packages/npm.md
#	v1.19/user/packages/nuget.md
#	v1.19/user/packages/pub.md
#	v1.19/user/packages/pypi.md
#	v1.19/user/packages/rubygems.md
#	v1.19/user/packages/storage.md
#	v1.19/user/packages/vagrant.md
#	v1.19/user/project.md
#	v1.19/user/protection.md
#	v1.19/user/push-options.md
#	v1.19/user/push-to-create.md
#	v1.19/user/repo-permissions.md
#	v1.19/user/webhooks.md
#	v1.19/user/wiki.md
#	v1.20/user/semver.md
2023-08-13 17:07:06 +01:00
Earl Warren
773be6dca2
refresh the installation guide with 1.20 2023-08-13 17:00:28 +01:00
Cyborus
8ad4341dd6
"loose" should be "lose"
# Conflicts:
#	v1.19/admin/upgrade.md
2023-08-13 16:59:46 +01:00
Peter Keenan
10f14eff87
Annotate localhost types 2023-08-13 16:37:04 +01:00
Peter Keenan
d6b2987330
Add host specific rules for pg_hba.conf section 2023-08-13 16:37:03 +01:00
Earl Warren
d87ee56faa
docs: admin: add missing documentation for WORK_PATH in app.ini
Refs: https://codeberg.org/forgejo/forgejo/issues/1118#issuecomment-1008533
2023-08-13 16:36:52 +01:00
Loïc Dachary
60aca1b265
docs: user: profile: document user custom profiles
# Conflicts:
#	user/profile.md
2023-08-13 16:36:21 +01:00
Loïc Dachary
38474aaa62
docs: user: authentication: move token scope out of the oauth2 section
# Conflicts:
#	user/token-scope.md
2023-08-13 16:36:21 +01:00
chrysn
5528363904
Add guidance for using podman with the runner 2023-08-13 16:36:21 +01:00
Earl Warren
0038bd1de9
docs: admin: upgrade: update to match v1.20.1-0 2023-08-13 16:36:21 +01:00
Earl Warren
c4d72a3668
docs: developer: WORKFLOW: rebase pull requests 2023-08-13 16:36:21 +01:00
Earl Warren
19ec284d9b
docs: admin: actions: typo - remove extra quote 2023-08-13 16:36:21 +01:00
Loïc Dachary
f29939c244
docs: developer: workflow: preserving stable branch tags (simplification) 2023-08-13 16:36:21 +01:00
Loïc Dachary
0589ab311b
docs: developer: workflow: preserving stable branch tags 2023-08-13 16:36:21 +01:00
Loïc Dachary
8e58214a84
Merge pull request 'docs: v1.20: sync with changes from Codeberg & Gitea' (#305) from dachary/website:wip-upgrade into main
Reviewed-on: https://codeberg.org/forgejo/website/pulls/305
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2023-08-13 16:36:07 +01:00
Loïc Dachary
cafdb8e16e
docs: v1.20: sync Codeberg 77bfb6cc15d180d506881e9629e73d1064c11dda 2023-08-13 16:35:43 +01:00
Loïc Dachary
a6d5b9e8bf
docs: v1.20: sync Gitea faa28b5a44912f1c63afddab9396bae9e6fe061c (update hash only) 2023-08-13 16:28:05 +01:00
Loïc Dachary
fb8705f312
docs: v1.20: sync Gitea faa28b5a44912f1c63afddab9396bae9e6fe061c
For each page of the documentation that has some content originating from Gitea, incorporate the updates.

git diff 62ac3251fa545d32bdfc9ff824106b97ec63edbb..faa28b5a44912f1c63afddab9396bae9e6fe061c -- $(find . -type f -name 'en-us')

Where faa28b5a44912f1c63afddab9396bae9e6fe061c is Gitea main as of today.
2023-08-13 16:28:05 +01:00
Loïc Dachary
4c5ea71000
docs: developer: add a section to build from source
# Conflicts:
#	developer/from-source.md
2023-08-13 16:28:04 +01:00
Loïc Dachary
5329ac985c
docs: admin: remove command line
It is supposed to reflect the help of `forgejo --help`. However, since
it is manually maintained there are differences that may be confusing.
It could be generated with `forgejo docs` but the format is not good
enough as it is.

# Conflicts:
#	admin/command-line.md
2023-08-13 16:27:56 +01:00
Loïc Dachary
84e8e3ab6d
docs: user: oauth2: fixed scoped token table display 2023-08-13 16:25:50 +01:00
Loïc Dachary
89b2cbea3a
docs: admin: actions: add missing actions
Fixes: https://codeberg.org/forgejo/website/issues/302
2023-08-13 16:25:43 +01:00
Earl Warren
8cfc9d602e
Merge pull request 'explain how Dockerfile based actions work' (#293) from earl-warren/website:wip-actions into main
Reviewed-on: https://codeberg.org/forgejo/website/pulls/293
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>

Merge pull request 'docs: admin: actions: document offline registration' (#294) from earl-warren/website:wip-actions into main
Reviewed-on: https://codeberg.org/forgejo/website/pulls/294
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>

Merge pull request 'docs: user: actions: jobs.<id>.service.<id>.ports is a noop' (#295) from earl-warren/website:wip-actions into main
Reviewed-on: https://codeberg.org/forgejo/website/pulls/295
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>

Merge pull request 'docs: user: actions: hashFiles does not work' (#297) from earl-warren/website:wip-actions into main
Reviewed-on: https://codeberg.org/forgejo/website/pulls/297
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2023-08-13 16:23:35 +01:00
Earl Warren
ccb4c2d154
docs: user: actions: hashFiles does not work
Refs: https://code.forgejo.org/forgejo/runner/issues/54#issuecomment-500
2023-08-13 16:22:49 +01:00
Earl Warren
36c42ea9f3
docs: user: actions: jobs.<id>.service.<id>.ports is a noop 2023-08-13 16:22:36 +01:00
Earl Warren
64e70b8eec
docs: admin: actions: upgrade to runner v2.3.0 2023-08-13 16:22:36 +01:00
Earl Warren
a47458b236
docs: admin: actions: document offline registration 2023-08-13 16:22:14 +01:00
Earl Warren
a006a44222
docs: user: actions: document steps.uses.with 2023-08-13 16:22:13 +01:00
Earl Warren
4bba8061f5
docs: user: actions: explain options for containers 2023-08-13 16:22:13 +01:00
Earl Warren
3871009d84
docs: user: actions: reword moderated pull requests 2023-08-13 16:22:06 +01:00
Earl Warren
6ab1d21f86
docs: user: actions: explain how Dockerfile based actions work 2023-08-13 16:22:06 +01:00
Earl Warren
e958209e29
docs: admin: actions: upgrade to runner v2.2.0 2023-08-13 16:22:06 +01:00
Earl Warren
07e8939ea6
docs: action: document service 2023-08-13 16:18:47 +01:00
Earl Warren
ef44ed51c1
docs: updates on the release process and how to debug it 2023-08-13 16:18:47 +01:00
Loïc Dachary
a8459ae139
Merge actions documentation into main
Merge pull request 'docs: more Forgejo Actions documentation' (#278) from dachary/website:wip-actions into main
Merge pull request 'docs: explain caching for Actions' (#279) from dachary/website:wip-actions into main
Merge pull request 'docs: document forgejo-runner exec & expressions' (#282) from dachary/website:wip-actions into main
Merge pull request 'docs: actions: document local actions' (#283) from dachary/website:wip-actions into main

Reviewed-on: https://codeberg.org/forgejo/website/pulls/278
Reviewed-on: https://codeberg.org/forgejo/website/pulls/279
Reviewed-on: https://codeberg.org/forgejo/website/pulls/282
Reviewed-on: https://codeberg.org/forgejo/website/pulls/283
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2023-08-13 16:15:18 +01:00
Loïc Dachary
5a0779d78d
docs: actions: document local actions 2023-08-13 16:14:14 +01:00
Loïc Dachary
1971c8b8ae
docs: actions: add expression to the glossary 2023-08-13 16:14:14 +01:00
Loïc Dachary
135f055f40
docs: actions: add expressions 2023-08-13 16:14:14 +01:00
Loïc Dachary
e927e6479b
docs: actions: add env: 2023-08-13 16:14:14 +01:00
Loïc Dachary
5d86d80c6d
docs: actions: explain how to run examples locally 2023-08-13 16:14:14 +01:00
Loïc Dachary
2b68a7066b
docs: actions: add forgejo-runner exec 2023-08-13 16:14:13 +01:00