0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-21 17:36:59 -05:00
Commit graph

720 commits

Author SHA1 Message Date
Earl Warren
920b0e97fd
update admin & user guide with semantic versioning
* Explain how the semantic version relate to the API
* Update the admin guide terminology
* Add a legacy section in the user reference guide
2024-03-02 20:41:58 +08:00
inference
8e7aa6b332 Semantic Versioning Updates (#460)
Preview: https://forgejo.codeberg.page/@docs_pull_460/docs/next/user/semver/

---

This pull request updates the Semantic Versioning mentions in the Forgejo documentation, as discussed in [forgejo/forgejo #2459](https://codeberg.org/forgejo/forgejo/pulls/2459).

It is currently a draft and feedback on how to approach this is appreciated. I think the Forgejo v1.19 section should be renamed to "legacy" or at least mention it due to it being the legacy versioning scheme, and moved below the new SemVer-compliant scheme. You can see how I've done that myself on [my website](https://inferencium.net/about.xhtml#versioning-numbering_scheme) for a taste of how it would look to a user.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/460
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: inference <admin@inferencium.net>
Co-committed-by: inference <admin@inferencium.net>
2024-03-02 10:54:49 +00:00
Earl Warren
937e55acc0 developer: releases: replace X.Y.Z+A.B.C with X.Y.Z+gitea-A.B.C
Followup of https://codeberg.org/forgejo/forgejo/pulls/2514
2024-03-02 10:31:08 +00:00
cascading-pr
87e204a528 cascading-pr update 2024-03-01 01:03:14 +00:00
Shiny Nematoda
6cc672040b admin: Document fallback behavior of repo indexer (#444)
ref: https://codeberg.org/forgejo/forgejo/pulls/1594

Preview: https://forgejo.codeberg.page/@docs_pull_444/docs/next/user/code-search/
Reviewed-on: https://codeberg.org/forgejo/docs/pulls/444
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Shiny Nematoda <snematoda@noreply.codeberg.org>
Co-committed-by: Shiny Nematoda <snematoda@noreply.codeberg.org>
2024-02-29 15:06:38 +00:00
Earl Warren
42d27fe502
developer: localization: warn before locking 2024-02-28 11:35:14 +01:00
Earl Warren
0127a9b0a4
developer: infrastructure: check for next.forgejo.org upgrades hourly 2024-02-27 12:41:31 +01:00
Andre601
da8202b897 User: Update info on configuring auth for maven package 2024-02-26 15:24:18 +00:00
Earl Warren
7dee6e6060 developer: infrastructure: no need for Enough, use ssh instead
It lowers the learning curve a little more for future sysadmins.

Also remove the obsolete hardware paragraph in the code.forgejo.org
page.
2024-02-26 14:18:39 +00:00
Earl Warren
09dfcc4ec0 sync with Codeberg 85d333f48badb27f8e4371263db3354f70836dfd
https://codeberg.org/Codeberg/Documentation

git diff 7bb8fa5ca559073c028805888195ee31b1f3d9c2..85d333f48badb27f8e4371263db3354f70836dfd > doc.patch
2024-02-25 18:03:50 +00:00
Earl Warren
24def40ad3 sync with Gitea d3982bcd814bac93e3cbce1c7eb749b17e413fbd
git diff abe8fe352711601fbcd24bf4505f7e0b81a93c5d..d3982bcd814bac93e3cbce1c7eb749b17e413fbd -- $(find . -type f -name '*en-us*')
2024-02-25 18:03:28 +00:00
Earl Warren
f9702d46cd
developer: infrastructure: next.forgejo.org auto-upgrades 2024-02-24 23:11:36 +01:00
Earl Warren
62c3b2540b
developer: release: the version metadata is not in the tag
It is added to the version when building it but is not part of the
release name.

Refs: https://codeberg.org/forgejo/forgejo/pulls/2459
2024-02-24 14:11:02 +01:00
Gusted
aa48cb3b99 admin: Add ambiguous character detection config
- Ref: https://codeberg.org/forgejo/forgejo/pulls/2427
2024-02-24 12:25:53 +00:00
Marko Korhonen
8bc412af4c
Fix typo 2024-02-24 11:19:09 +02:00
Earl Warren
6bb6309a4e
developer: release process update for the hard fork
* Release number is v7.0.0+1.22.0 and following semantic versioning
* Remove the workflow page which is no longer needed as:
  * it is implicitly understood pull requests go to the default branch
  * testing requirements are documented in the testing.md page
* Explain how to cut a release and set the tag in forgejo-integration
  for proper numbering of the test releases that come out of the
  development branch

Refs: https://codeberg.org/forgejo/forgejo/pulls/2448
2024-02-23 16:53:01 +01:00
Earl Warren
299a3a2951
developer: testing: split this section out of compilation 2024-02-21 23:41:46 +01:00
Earl Warren
a50d5e1f00
developer: localization: admin duties
after a few rounds of merging translations the checklist is slightly
different
2024-02-21 14:39:50 +01:00
Gusted
162f0ad25c
admin: add new option to config cheat sheet
- Ref: https://codeberg.org/forgejo/forgejo/pulls/2418
2024-02-21 11:55:43 +01:00
Gusted
a4e1851ff2
user: Clarify value of force-push in AGit
- Clarify that if you want to use this parameter the value should be set
to `true` (other values may work, but that can be restricted later).
- Ref: https://codeberg.org/forgejo/forgejo/pulls/2386#issuecomment-1572905
2024-02-19 13:30:51 +01:00
Otto Richter
bd2e86a799 Drop support for Microsoft SQL Server 2024-02-18 20:51:58 +01:00
Panagiotis "Ivory" Vasilopoulos
d12a9fee60 admin/customization: No need to be a developer for custom branding (#427)
Preview: https://forgejo.codeberg.page/@docs_pull_427/docs/next/admin/customization/

---

The previous version of this document insinuated that you need to be
familiar with Forgejo's source code and compile Forgejo from source
for custom branding changes. As of the most recent Forgejo version,
this is not necessarily true, as custom files can be served from
the CustomPath.

Administrators that were not developers therefore dismissed the
other guide and its contents without reading this, and I was one
of them. I thought it would make sense for this file to provide
information on where to put a custom logo. This change does not
fix it (this will be done later), but it will reduce the confusion
for now.

This warning confused me personally and other Forgejo users, as I
had one person tell me IRL that they thought that it was not possible
to serve a custom logo.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/427
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-committed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2024-02-18 17:22:54 +00:00
François Kooman
29d9296d14 clarify which reverse proxy configuration fields need to be under [security] 2024-02-18 15:29:33 +00:00
Panagiotis "Ivory" Vasilopoulos
6c755e61f4 developer/customization: use example.com example domain 2024-02-18 15:28:10 +00:00
Slatian
4b8db5a048 In issue-pull-request-template documentation, deduplicate contact link name key
The Table under "Contact Link" has two rows labeled `name` with exactly the same content, it should only occur once.
2024-02-18 12:40:05 +00:00
Earl Warren
c81c50daa4
admin: installation: v1.21 is current 2024-02-17 11:40:29 +01:00
Panagiotis "Ivory" Vasilopoulos
d0acbd9821 Change topic branch example to avoid confusion 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
19be4452a0 Clarify the differences between session and topic better 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
89c17ef6a7 fix small markdown error 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
a927273363 retrospectively -> retroactively 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
c71eebd1da OK, I know I said that I'd drop this for now like a thousand times
... but there was this sentence that I just read again and
it annoyed me :(
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
18df26e318 Change title to 'AGit Workflow Usage' 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
bef6fc5197 topic -> topic 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
ff08aab827 topic is optional when <session> exists 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
7063f466bc remove half-finished line 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
037209620b change order of push options 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
aa03b7e78c small language improvements 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
6472e357b7 'For clarity reasons' instead of 'For reasons of clarity' 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
1493478a2a Reiterate caveats, again 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
86a01ada3a Capitalization error, s/instructions/information 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
27f930aeb7 wrong " 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
b0dadbd6c5 \ 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
0cf21c22c5 Clean things up, address review comments
- Improve background information
- Move Caveat information to parameter explanations
- Add <session> example
2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
389a056329 improve typo 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
c3ed73b805 fix typo 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
4f96b73679 improve topic stuff, break examples into multiple lines 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
7c3ba56acb add information for gerrit users, improve caveats 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
45bc09ace6 improve background information and examples 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
96ee352885 fix error in example 2024-02-13 11:21:47 +00:00
Panagiotis "Ivory" Vasilopoulos
6e1950122e add git internals book reference 2024-02-13 11:21:47 +00:00