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>
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>
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>
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>
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>
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>
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>
## Summary
- clarify that HTTPS Git auth should use an access token as the password when 2FA is enabled
- update both the first repository guide and the CLI clone/commit guide for consistency
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/784
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
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>
SourceHut: A minimum-GUI Free Software based service at first read as "minimum and GUI free and it's software based", which might be confusing for some people and is not intended
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/779
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Since [codeberg-cli](https://codeberg.org/Aviac/codeberg-cli) has been discontinued, update the section on CLI clients to recommend forgejo-cli, which the codeberg-cli maintainer endorses.
Given the endorsement, I presume that it's worth recommending in the docs, even though the project is relatively young. Having used it myself, I can vouch for it.
I wrote a brief overview of forgejo-cli to contrast it slightly with `tea`.
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/773
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: leeroyjankins <hatemail@jank.wtf>
Co-committed-by: leeroyjankins <hatemail@jank.wtf>
### Description
This fixes#761, more specifically the part (2) of their issue post. The issue was that it was not clear that the "." at the end of the command was meant to be excluded. Even if its clear to some, accidental copy and paste with the inclusion of "." have happened. Therefore, this PR is more of an improvement to the so called "quality of life".
**The fix**
Separating the commands in to code blocks and excluding the "." from the end.
**Other additions**
- The commands are also now described.
- A new command that allows users to check their current configuration in order to verify that things are as they intended. This commands
Source for both of these additions is: https://janik6n.net/posts/signing-git-commits-with-ssh-key/
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/762
Co-authored-by: spuzkov <spuzkov@tuta.com>
Co-committed-by: spuzkov <spuzkov@tuta.com>
Closes#752.
Co-authored-by: David Anselmi <danselmi@intecrowd.com>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/755
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Dave Anselmi <danselmi@noreply.codeberg.org>
Co-committed-by: Dave Anselmi <danselmi@noreply.codeberg.org>
