mirror of
https://codeberg.org/Codeberg/Documentation.git
synced 2026-06-16 05:13:54 -07:00
c6ac9a9f94
# 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>
78 lines
3.7 KiB
Markdown
78 lines
3.7 KiB
Markdown
---
|
|
eleventyNavigation:
|
|
key: FirstSteps
|
|
title: Your First Steps on Codeberg
|
|
parent: GettingStarted
|
|
order: 20
|
|
---
|
|
|
|
## Registering at Codeberg.org
|
|
|
|
To create your account at Codeberg.org, visit [https://codeberg.org](https://codeberg.org)
|
|
and click on "Register" to bring up the registration form.
|
|
|
|
Then, simply fill in your username and email address and then choose a good password.
|
|
|
|
After confirming your email address by clicking the link in the email we sent you,
|
|
you're done and good to go!
|
|
|
|
## Community
|
|
|
|
Codeberg is a non-profit volunteer effort. It relies on its friendly and dedicated community.
|
|
We're happy that you're now a part of our community, too, and we hope you're feeling welcome!
|
|
|
|
We kindly ask you to be polite and civil when on Codeberg and to not excessively use the resources provided.
|
|
Please see our [Terms of Use](https://codeberg.org/codeberg/org/src/TermsOfUse.md) for details.
|
|
|
|
Please remember that everyone here is contributing on their free time, as volunteers.
|
|
|
|
If you like a project on Codeberg, consider **giving it a star** and/or **following its author**.
|
|
This helps with building and growing a network of free software projects and people, and can serve as guidance for users
|
|
exploring Codeberg, looking for interesting projects to try out or contribute to.
|
|
|
|
## Orienting yourself on Codeberg
|
|
|
|
After successfully registering on Codeberg, you should see something similar to this screen:
|
|
|
|
<img src="/images/getting-started/first-steps/dashboard.png" alt="Dashboard">
|
|
|
|
An explanation of the highlighted elements above:
|
|
|
|
- **Dashboard (1)** is the screen you're looking at right now. It gives you an overview of the latest activity
|
|
from you, the people you follow and in your or your organization's projects.
|
|
- **Issues (2)** and **Pull Requests (3)** These are overviews of issues and pull requests that you are either involved
|
|
in or that are part of one of the organizations you belong to.
|
|
- **Codeberg Issues (4)** This is currently the primary communication channel for the Codeberg Community.
|
|
Here, you can ask questions, report bugs and suggest changes to Codeberg. You're also welcome to browse these issues
|
|
and contribute your solutions, if you want to support Codeberg even more.
|
|
- **The Create Menu (5)** You can create repositories, organizations and migrate repositories using this menu.
|
|
It's your entry point to kicking off entirely new projects on Codeberg.
|
|
- **Your Avatar (6)** will lead you to a menu, where you can look at your profile, edit your settings,
|
|
read the documentation of Forgejo (the software Codeberg is based on) or log out.
|
|
- **The Dashboard Context Switcher (7)** If you're part of one or more organizations, you can use this context switcher
|
|
to let the dashboard display information relevant to the organization, rather than your account.
|
|
|
|
## A word about Security
|
|
|
|
While it is important to choose a strong password, it is also
|
|
important to use Two-Factor Authentication in case your password or device
|
|
ever gets compromised, so that should be one of the first things to
|
|
configure after you have created your account.
|
|
|
|
We recommend that you use Two-Factor Authentication, to increase
|
|
your security.
|
|
|
|
{% admonition "info" %}
|
|
|
|
Please visit the [guide in the security section](/security/2fa) to learn how to set up 2FA.
|
|
|
|
{% endadmonition %}
|
|
|
|
## Moving on from here
|
|
|
|
Now that you have an account on Codeberg, you can choose from a number of possible ways to explore:
|
|
|
|
- [Create your first repository](/getting-started/first-repository)
|
|
- [Report or comment on an issue](/getting-started/issue-tracking-basics)
|
|
- [Learn how to use Git](/git) and then [contribute a pull request](/collaborating/pull-requests-and-git-flow)
|
|
- [Contribute to Codeberg](/improving-codeberg)
|